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This guide is a standard library item (SLI). It is part of the standard library provided automatically with the purchase of the 
product. 


This guide describes how to interpret Operating System/3 (OS/3) dumps to help you understand job or system conditions. 
It contains the following: 


© Descriptions of the structure and functions of OS/3 software 

¢ Explanations of the task control block (TCB) and the program status word (PSW) 
* Descriptions of three OS/3 dumps 

© Sample dump analyses 


For Release 12.0, this guide adds parameters to the suboption SELECT and incorporates minor technical and editorial 
changes. 


Destruction Notice: This revision supersedes and replaces the Dump Analysis User Guide/Programmer Reference, 
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Additional copies may be ordered through your local Unisys representative. 
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About This Guide 


Purpose 


This guide discusses dump analysis primarily as it applies to user jobs. 


Scope 


This guide contains the following: 

e Explanations of the task control block (TCB) and the program status word (PSW), 
two of the most important structures in dump analysis, and an overview of the 
structure and functions of Operating System/3 (OS/3) software 

e An overview of OS/3 dumps 


¢ User dump analysis with examples 


Audience 


The intended audience for this guide is the programmer, who will use dump analysis 
to help develop and maintain Unisys software, programs, and files. 


Prerequisites 
Anyone using this guide should understand the following: 
¢ Unisys OS/3 machine language 
¢ How to read a dump 


¢ Job organization 


How to Use This Guide 


Read the entire guide to familiarize yourself with the basic concepts it presents; then 
use it for reference as needed. 
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About This Guide 





Organization 


This document contains four sections and two appendixes: 
Section 1. Introduction to Dump Analysis 

Defines dump analysis, and explains when you need dumps. 
Section 2. OS/3 Overview 


Gives a basic overview of OS/3, including the supervisor and user region, and several 
data structures and registers. 


Section 3. Dumps and Their Formats 


Describes the three types of dumps OS/3 provides: $Y$DUMP, JOBDUMP, and EOJ 
dump. 


Section 4. Sample Dump Analyses 


Presents examples of dump analyses applied to actual user programs by using the 
ideas presented in the previous sections. 


Appendix A. Program Exceptions 





Lists the interrupt codes and their causes. 
Appendix B. $Y$DUMP File Allocation 
Shows the number of cylinders required for $Y$DUMF file allocation, depending on 


your system’s main storage capacity and the type of disk device you are using. 


Results 


After reading this document, programmers will be able to use dump analysis to correct 
program errors. 


Related Product Information 


The following Unisys documents may be useful in understanding and implementing 
dump analysis. 


Note: Throughout this guide, when we refer you to another manual, use the version 
that applies to the software level at your site. 
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Processor - System 80 Programmer Reference (UP-888]1) 


Provides the detailed hardware-oriented information required to program the System 
80 processor. Includes a brief functional description and configurations. 


Supervisor Technical Overview (UP-8831) 


Provides an overview of the OS/3 supervisor and its functions for OS/3 high-level 
language programmers and site administrators. 


Assembler Programming Guide (UP-8913) 

Describes, for both novice and experienced programmers, the OS/3 basic assembly 
language (BAL) and its use. Discusses general language concepts, assembler 
instructions, and programming techniques. 


System Messages Reference Manual (UP-8076) 


Lists the system messages and describes them. Message description composed of the 
remedial action or response required as applicable. 


Job Control Programming Guide (UP-9986) 


Provides information on the format and use of job control statements and job control 
procedure calls (jprocs). 


Hardware and Software Programming Quick-Reference Guide (UP-8868) 


Summarizes machine instructions, supervisor related information, physical 
input/output control system (PIOCS) information, and I/O sense data byte definitions. 


System Service Programs (SSP) Operating Guide (UP-8841) 


Describes the system services programs, the utility programs that support the 
operation and organization of the operating system. 


Operations Guide (UP-8859) 

Describes the hardware configuration of each System 80 model, presents procedures 
for initializing the system, and describes all commands and procedures used within 
the OS/3 environment. 


Installation Guide (UP-8839) 


Provides the system administrator with information and procedures necessary to 
install, tailor, and maintain OS/3 software in a System 80 environment. 


UP-9980 Rev. 1 vil 





About This Guide 








Notation Conventions 
The notation conventions used in this guide are the following: 


e Capital letters, commas, equal signs, and parentheses must be coded exactly as 
shown. For example: 


SET SY,LOFF 

(SELECT) 

FILE=$Y$DUMP 

¢ Lowercase letters and words are generic terms representing information that 

must be supplied by the user. Such lowercase terms may contain hyphens and 
acronyms (for readability). For example: 

vsn (volume serial number) 

decimal -area-number 

job/symbiont-name 


did (device identification number) 





¢ Information contained within braces represents mandatory entries of which one 
must be chosen, such as: 


DISPLAY= fstartaddr:n 


X'XXXXXXXX! [startaddr-endaddr ] 
C'ccececcc! 


JOBS 
e Information contained within brackets represents optional entries that 
(depending upon program requirements) are included or omitted. Braces within 
brackets signify that one of the specified entries must be chosen if that parameter 
is to be included. For example: 


[,P=did] 


,V= [vsn 
(vsn,AT) 
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An optional parameter having a list of optional entries may have a default 
specification that is supplied by the operating system when the parameter is not 
specified by the user. Although you can specify the default, you do not have to. 
For easy reference, when a default specification occurs in the format delineation 
it is printed on a shaded background. For example: 


,SPL { PRINTER 
TAPE 


,FILE= { $YSDUMP 
(bl name 


If, by parameter omission, the operating system performs some complex 
processing other than parameter insertion, it is explained in the parameter 
description. 


When a portion of a parameter is underlined, only that portion need be specified. 
For example: 


[ ,MLIB=NO] 
can be coded as: 


[,MLIB=N] 
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Section 1 
Introduction to Dump Analysis 


1.1. General 


Dump analysis is one of the set of diagnostic tools available for your use in developing 
and maintaining Unisys Operating System/3 (OS/3) software, programs, and files, A 
raw dump itself is a hexadecimal image of the system main storage and registers at 
the time of the dump, which is output to a printer. Dump facilities in OS/3 
supplement a raw dump by extracting from it information needed to interpret job or 
system conditions. Dump analysis is the process by which you interpret the dump and 
is one of your primary tools for uncovering errors and problems in your OS/3 
programs. 


1.2. When Dumps Are Needed 


Dumps are used on a number of occasions: 


e When a HALT AND PROCEED (HPR) occurs. Many HPRs listed in the System 
Messages Reference Manual (UP-8076) request that the operator perform a dump. 


e When a system hang occurs. If the system remains in a run state but cannot 
communicate with the operator, a dump is often taken. 


¢ When a user job terminates with an error. If certain job control language (JCL) 
options are specified, the system will react to the error by generating a dump and 
sending it to a printer. 


¢ When some system errors will automatically generate a system dump. 


While the dump is an important diagnostic tool to you, it is an equally important tool 
for your Unisys representative, if a system problem is serious. For less serious 
problems, though, you can analyze your own dumps and resolve your program 
problems. In fact, the emphasis in this guide is on analyzing job failures, since system 
failures usually require the services of a Unisys representative. 
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Section 2 
OS/3 Overview 


2.1. General 


To do dump analysis, you should know some of the operation of OS/3 software. For 
OS/3 operation, main storage can be divided into two parts: the supervisor and the 
user region. The supervisor is the complex of routines that prepares user programs 
for running, serves as the primary I/O software interface, and, most importantly for 
dump analysis, handles unexpected or error conditions. The user region contains your 
program and is where most user-solvable problems occur. The two areas, supervisor 
and user region, occupy separate parts of main storage and share in the use of several 
data structures and registers, the most important of which are the program status 
word (PSW) and the task control block (TCB). 


2.1.1. Program Status Word (PSW) 


One of the most important registers in OS/3 is the current program status word. This 
register contains the address of the next instruction to be executed as well as other 
indicators and flags which, taken together, define the hardware status of the system. 


The format and description of the PSW are: 


INTERRUPT CODE 


INSTRUCTION ADDRESS 
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2-2 


A complete description of the PSW can be found in the appropriate processor 
programmer reference. For our discussion, you need know only about the unshaded 
fields shown in the previous illustration: 


PR (bit 13) 

Defines the general register set to be used in executing an instruction. The 
processor contains two sets of 16 general registers: problem registers and 
supervisor registers. The set the processor uses is determined by the following 
settings of bit 13: 

PR=1 Problem registers 

PR=0 Supervisor registers (not for user analysis) 

PS (bit 14) 

Specifies one of two processor modes of operation: 

PS=1 Problem mode 

PS=0 Supervisor mode (not for user analysis) 

In problem mode, all privileged machine instructions are invalid, and their 
attempted execution results in a program exception (interrupt code 02; see Table 
A-1). In supervisor mode, all instructions may be executed. 


Interrupt code (bits 24-31) 


Contains the interrupt code used in software analysis of interrupts. A list of the 
interrupt codes used in OS/3 is shown in Table A-1. 


ILC (bits 32-33) 


Contains the instruction length code, the length in half words of the instruction 
being executed at the time of an interrupt. For each instruction, the instruction 
address field is incremented by the number of bytes indicated in the ILC for that 
instruction. 


Instruction address (bits 40-63) 
Contains the address of the next instruction to be executed, obtained when the 


OS/3 hardware adds the address of the currently executing instruction to the 
length of that instruction. 
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Because the last field of the PSW, the instruction address, points to the next 
instruction, it can be altered by hardware branch instructions. The address can also 
be stored in main storage, if the current program is interrupted, and later loaded back 
into the PSW, permitting the program to resume without loss of control. The OS/3 
software handles a number of such interrupt types, including: 


e Program exception - issued by the hardware when it detects the improper use of a 
machine instruction or data. 


¢ Machine check - issued by the hardware when it detects a hardware failure. 


e¢ Supervisor call - issued by user programs through use of the SVC instruction. 
SVC is the user’s primary interface to the supervisor and may be used to call 
transients (2.2.1). 


The OS/3 software contains error routines that handle each type of interrupt. Figure 
2-1 shows how an interrupt is handled. When an interrupt occurs, the processor 
microcode swaps the current PSW of the interrupted program (PROG1) with a new 
PSW used for handling the interrupt. 


The PSW for PROG1 (old PSW) is stored in a reserved slot and is used later to 
determine at which instruction PROGI is to resume. The new (now current) PSW of 
PROG2 is loaded into the PSW register and sets the system in a new state that 
branches to the supervisor error routine (PROG2) that is designed to handle the 
interrupt. 


When PROG2 routine is finished, a LOAD PSW instruction usually loads the old PSW 


back into the PSW register, thus returning processor control to PROG1. The 
hardware maintains a pair of PSWs, old and new, for each type of interrupt. 
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Figure 2-1. Handling an Interrupt 


Because these interrupts may represent either an error condition or the operating 
system’s response to one, their old PSWs can provide clues to the cause of an error. 


2.1.2. Task Control Block (TCB) 


Besides PSWs, the structure you may analyze most thoroughly in a dump is the task 
control block (TCB). Up to 255 TCBs may be active in OS/3 at any time, and each of 
these represents a task that is competing for processor time with all other tasks. A 
TCB contains fields that completely define its task to the rest of the system; the TCB 
thus serves as a software counterpart to the hardware-oriented PSW. 
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For dump analysis, certain fields are important, and these are represented by the 
unshaded portion of the following TCB format diagram: 


RELATIVE 0 4 8 c 10 14 18 ic 
ADDRESS 


000000 
000020 REGISTER SAVE AREA 
000040 


000060 








¢ PSW Save Area (byte offset 20,,-27 44) 


Two full words into which the old PSW is stored in the event of an interrupt 
occurring in the task. When the task resumes processor control, this data is 
loaded back into the current PSW. 


On abnormal termination, the PSW is also stored in the last five bytes of the 
preamble and the interrupt code and instruction address are displayed and 
written to the job log. This information is useful if a dump is not obtained. 

e Register Save Area (byte offset 28 ,,-67,,) 
Sixteen full words into which the contents of the current register set are stored 
when an interrupt occurs in the task. When the task resumes processor control, 


these full words are loaded back into the proper register set. 


You can find more detailed information of TCBs in the Supervisor Technical Overview 
(UP-8831). 
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2.2. OS/3 Structural Overview 


This subsection summarizes some of the important OS/3 structures that are resident 
in main storage and describes how they are linked together. A knowledge of these is 
important to dump analysis. Broadly, main storage is allocated as follows: 












000000 
| SUPERVISOR 
ASCENDING 
ADDRESSES 


JOB REGION 
JOB REGION 
JOB REGION 


a ae. 


The OS/3 supervisor occupies the low-order part of main storage. Job regions occupy 
some parts of high-order main storage, with free regions taking up the remainder. 
The formats of the supervisor and of the job regions are discussed in the following 
subsections. Samples of these are in the dumps shown in Section 3. 


! 





2.2.1. Supervisor 


Three areas of the supervisor are often used in dump analysis: low-order main 
storage, the system information block, and the transient area. 
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Low-Order Main Storage and Relocation Registers 


The first 4096 bytes of the main memory unit for the System 80, models 8 through 20 
are reserved for special purposes by the operating system and thus cannot be used as 
a storage area for ordinary data and instructions. In System 80, models 3 through 6, 
low-order main storage occupies the lowest 256 bytes of main storage. One area of 
low-order main storage is of interest in dump analysis; this is shown in the following 
illustration: 


Byte Address 
(Hexadecimal) Oo 1 2 3 4 5 6 7 8 9 A B. Cc D CE F 
OOx 


1/0 old PSW I/O new PSW 
03x Exigent machine check Exigent machine check 
old PSW new PSW 
04x Program check old PSW Program check new PSW 


05x Supervisor call old PSW Supervisor call new PSW 
External old PSW External new PSW 
Repressible machine check* Repressible machine check* 
old PSW. new PSW ] 
PER old PSW PER new PSW 
09x Restart old PSW* Restart new PSW* 
OAX 





* Not used in Model 8. 


Low-order locations 000020 through 00009F contain, for each type of interrupt 
supported in System 80, the new PSW that is always loaded into the current PSW 
register, and the old PSW that is swapped out. The PSWs for program checks, 
machine checks, and SVCs have already been discussed; of these, the program 
exception will figure the most in the dump analyses shown in Section 4. 


In addition to the data kept in low-order main storage, the system uses 16 relocation 
registers (identified as 0 through F,,) for models 3 through 6 and 64 relocation 
registers (identified as 1-40,,) for models 8 through 20. In the operating system, 
models 8 through 20 provide up to 48 user jobs, each using one of the registers 1-30,, 
as its base. For models 3 through 6, the maximum number of user jobs is 14 and each 
job base is one of the registers 1-E,¢. 
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These registers should not be confused with the base registers used within programs, 
especially by BAL programmers; in fact, every effective address within a job is added 
to the job’s relocation register to get the absolute address required, a process generally 
transparent to users. 


All TCBs within a job specify the relocation register for that job in byte 0. While the 
job has processor control, its register number occupies bits 8-11 of the current PSW. 
Register 0 is reserved for the supervisor; the field contains a value of zero, which 
permits supervisor routines to address the entire address space of a system. Because 
it is important to distinguish between system errors and job errors in dump analysis, 
job regions and relocation registers are further discussed in 2.2.2. 


System Information Block (SIB) 
The system information block (SIB) occupies supervisor space just past low-order 


main storage. Fields within the SIB are often used in dump analysis and are 
presented in the following illustration: 


+0 +4 +8 +C +10 +14 +18 +1C 





ADDR OF 
1ST TRANS 


CURRENT 
TCB 








NOTE: | Not used 


Bytes 40 to 43 contain the full-word address of the first transient area (see 2.2.1). The 
two half words in bytes 84 to 87 define the user region with the keys to the first and 
last user blocks. The address in bytes 94 to 97 points to the current TCB, which is the 
last TCB given control by the system (see 2.3.1). 
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Transients 


To handle system tasks OS/3 uses two basic types of routines: supervisor overlays and 
transient routines. Supervisor overlays occupy a single 1192-byte area within the 
supervisor; these are routines that are loaded when needed to handle urgent tasks, 
such as operator communications. Transient routines are loaded when needed, occupy 
several contiguous 1192-byte areas of supervisor, and can be called by user jobs or by 
other transients. 


2.2.2. Job Regions 


Each user job in OS/3 occupies a single job region in main storage. Within that region 
are all the fields unique to that job, including: 


e Job preamble 
¢ Job TCBs 


¢ Load module 


The job preamble contains data about the job that is used by the supervisor in 
scheduling, running, accounting, and terminating the job. The TCBs, of which at least 
one exists for each job, represent the individual tasks that may compete for processor 

& time while the job is run. The load module is scheduled and loaded through job 
control language (JCL) or as a symbiont and may contain one or more phases. 
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PREAMBLE 


000000 


000120 


0000CO 


2-10 


SW PRIORITY | 





As mentioned in 2.2.1., models 3 through 6 have 14 user slots and models 8 through 20 
have 48 user slots. This means that System 80 allows you to run simultaneously up to 
14 user jobs on models 3 through 6 and up to 48 user jobs on models 8 through 20. 
Pointers within each job preamble point to other jobs and to free regions (see 2.2.4). 
Each job uses one of the relocation keys discussed in 2.2.1. Five fields in the preamble 
are often used in dump analysis, as shown in the following illustration: 


4 8 A Cc 10 14 18 1c 20 Bytes 


NUMBER 
OF BYTES 
ASSIGNED 

TO JOB 


JOB NAME STORAGE | STORAGE 


ADDRESS | ADDRESS 





123 127 


CURRENT 
PSW 


ACTIVE 
FILE 
TABLE 
ADDRESS 





NOTE: 


Not used in analysis 


The eight bytes starting at location 0 contain the name of the user’s job coded in 
EBCDIC. The two half words starting at locations 8 and A point to the user regions 
immediately following and preceding this region, thus defining the space addressable 
by this job. A user region can be a job, a symbiont, or a free region. Location C 
contains the number of bytes assigned to this job. 


Location 120 contains the switch priority, if a switch command is entered that is to be 
in effect for the entire job. Otherwise, this byte will be zero. 
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Location 123 through 127 will contain the low-order five bytes of the current PSW 
(containing the interrupt code and instruction address) when a job abnormally 
terminates. Job control will write this information to the job log and display. 


Location CO contains the address of the active file table, which is used as an interface 
between the job and the files assigned to it (see 4.4.2), 


2.2.3. Symbionts 


Symbionts are dynamic extensions of the supervisor which occupy user main storage 
in much the same way as do user jobs. Each symbiont has a job-like preamble, TCBs 
preceding the code executed in the symbiont, and other necessary structures. 


Some of the differences between symbionts and jobs lie in priority (see 2.3.1) and 
relocation keys: symbionts use key 0 (the supervisor) and run in supervisor mode; also, 
symbionts are loaded from the low-order end of user main storage upwards and are 
scheduled and loaded separately from job control. 


2.2.4. Free Regions 


As explained in 2.2, free regions are those parts of the user region not allocated to user 
jobs or symbionts. These regions are not simply ignored in OS/3, however: like a job 
or symbiont, each such region has a preamble with pointers in locations 8-B indicating 
the jobs/symbionts immediately preceding and following it, thus maintaining forward 
and backward links throughout the entire user region. 


2.2.5. Structure Summary 


The separate structures and pointers of an OS/3 system can be pulled together into a 
single diagram, shown in Figure 2-2. 
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000000 
RELOC.**| ReLOc. | RELOC. | RELOC. 
REG. | REG. | REG. REG. po eaDes 
TO EXECUTABLE : A a MAIN STORAGE 
CODE (1024 BYTES) 
Jos #2 
ADDRESS OF 
FIRST TRANSIENT 
SIB 
ADDRESS OF FIRST | ADDRESS OF LAST 
USER MAIN USER MAIN 
eniiee STORAGE REGION | STORAGE REGION 
SUPERVISOR 


TO FIRST BYTE 
JOB #1 


SOA 
(1192 BYTES) 


TRANSIENT 
AREA #1 
{1192 BYTES) 
TRANSIENT 
AREA #2 
(1192 BYTES) 


TRANSIENT 
AREA #3 
(1192 BYTES) 





SYMBIONT 


FREE 
REGION 


| USER 
REGION 
JOB#H2 





NEXT LAST 
Z REGION | REGION 
*NEXT LAST 
REGION | REGION 

















JOB#1 
HIGH-ORDER 
END OF 
MAIN 
STORAGE 


*Contains O's indicating that it does not point to another region. **Relocation registers not in main storage 


Figure 2-2. Summary of OS/3 in Main Storage 
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In Figure 2-2, two jobs and one symbiont are running concurrently, leaving a free 
region between them. Note that two relocation registers in low-order main storage are 
each pointing to the first byte of executable code in a job region. In analyzing dumps 
caused by errors within a user job, these relocation values can help determine 
specifically what job caused the error. Note that each job can have more than one 
TCB, although only one TCB can be active at any time. 


2.3. Functional Description 


This subsection summarizes some of the major operations of OS/3 software. You can 
find more information in the Supervisor Technical Overview (UP-8831). For dump 
analysis purposes, this discussion focuses on OS/3 tasks and task handling. 


2.3.1. TCBs and Multitasking 


As described previously, OS/3 tasks are processes that compete with other tasks for 
processor time. Each task is defined by an associated TCB. Each job or symbiont in 
the system is considered a primary task to which other tasks may be attached. The 
supervisor overlay and transient areas are individual tasks having one TCB each. 


Tasks can be active or waited. An active task is one capable of getting processor 
control, but a waited task is made ineligible for processor control and must wait, 
@ usually for some event to occur, until it can be made active again. 


Tasks are allotted processor time by the task switcher, a supervisor routine that scans 
all active tasks and chooses one among them to get the processor’s attention. The 
TCB having the highest priority gets the processor first. Figure 2-3 shows the relative 
priorities assigned to different classes of TCBs. 





UP-9980 Rev. 1 2-13 


















OS/3 Overview 
HIGHEST SWITCH LIST 
PRIORITY 
PRI : 
RIORITY: 0 ok TCB 
DIRECTION SPOOLER 
TCB 
oe RES sceaatineay 
SYMBIONTS/TRANSIENTS 
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Figure 2-3. OS/3 Task Priorities 


Note that the supervisor overlay TCB has the highest priority since supervisor 
routines must be run as soon as they are needed. As you move down the list, the tasks 
move from supervisor-oriented to user-oriented until you reach priority 4, the highest 
priority a user task can have. 


Some priority levels have more than one task, although the tasks may be associated 
with different jobs and routines. When one task finishes or is interrupted, the 
switcher usually gives processor time to the next TCB at that priority if one exists and 
is active. Otherwise, the switcher scans lower priorities until it finds another active 
TCB to which to give processor control. 


2.3.2. Task Switching Considerations 


2-14 


Switcher activity within a system can be determined from a dump and can thus help 
tell you why an error occurred within a job (which, remember, is itself a task operated 


on by the switcher). 


Much task switching is done in response to an interrupt. When an interrupt is 
processed (Figure 2-4a) the current PSW is stored in the appropriate old PSW region 
of low-order main storage (step 1A). The corresponding new PSW is then loaded into 
the current PSW, thus handling processor control to an interrupt handling routine 
(step 1B). That routine in turn copies the old PSW into the double word PSW save 
area in bytes 20-27 of the interrupted task’s TCB (step 2). Next, the routine in control 
stores the 16 registers used by the interrupted task into bytes 28-67 of the same TCB 
(step 3). (This step is omitted if control goes back to the same task as the one 
interrupted.) Finally, the interrupt handler returns processor control to the switcher. 
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The result of these operations is that control can be easily returned to the interrupted 
task when the time comes. This is shown in Figure 2-4b when the switcher gives 
control to a task which, like the task in Figure 2-4a, has had its registers and PSW 
saved. The switcher simply loads the 16 registers from the register save area (step 1) 
and the current PSW from the PSW save area (step 2). Control then passes to the 
instruction pointed to by the now-current PSW and the newly activated task begins 
processing. 


As you will see later, task switching within a job is often prompted by interrupts 
responding to errors: in these cases, the old PSW (saved in the TCB of the interrupted 
task) shows which instruction caused the error. This is one of the most important 
techniques of dump analysis and is used extensively in the dump analyses in Section 
4, 


INTERRUPT @ 


HANDLING 


& OLD PSWs 


ROUTINE 





PSW REGISTER 


Tos 
| sero 
SWITCHER 
NEW PSWs 


*Registers are not saved in the TCB if interrupted task 
is to receive control back directly. 





INTERRUPTED TASK 


REGISTERS 


a. Saving the environment of an interrupted task 


Figure 2-4. Passing Control from Task to Task (Part 1 of 2) 
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Figure 2-4, Passing Control from Task to Task (Part 2 of 2) 
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Section 3 
Dumps and Their Formats 


3.1. General 


OS/3 provides three types of dumps. While all are basically hexadecimal images of 
main storage at the time they are taken, they differ in scope and purpose as follows: 


SYSDUMP 


Dumps all or part of main storage and is run in two phases: main storage write 
and dump printout. In addition to the raw dump, the printout can provide a 
picture of your system in charts and text. 


To produce an OPTION SYSDUMP, the RUN pack must have enough contiguous 
free space to store a copy of the system’s main storage. See Appendix B fora 
procedure to allocate enough file space for your system. 


JOBDUMP 


Dumps a user’s job region upon abnormal termination of the job or execution of 
the DUMP or CANCEL macros. The raw dump is supplemented by charts and 
text interpreting the state of the job, JOBDUMP requires space on the first 
VTOC cylinder of SYSRUN to allocate files. You should eliminate unused files on 
SYSRUN. 


EOJ Dump 


Dumps a user’s job region without translation as well as the registers and the 
PSW. 


The three types of dumps contain some common features, particularly in the user 
regions. The type of dump you choose to take will depend on some of the following 
considerations: 
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HALT AND PROCEED (HPR) errors often require a SYSDUMP so that Unisys 
representatives can analyze system problems. 


System loops or hangs, usually appearing as operator communications that 
receive no reply from the system console, require a SYSDUMP. Like HPR errors, 
these usually require that a Unisys representative analyze your dump for system 
problems. 
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¢ User job errors generally occur within the user’s own job region, thus requiring 
nothing more than a JOBDUMP or EOJ dump. These are the dumps you are 
most likely to work with in analyzing user program errors. 


3.2. System Dump Routine (SYSDUMP) 


3.2.1. SYSDUMP Makeup 
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The system dump routine (SYSDUMP) is most often used to determine why your 
system failed. But it may be used at any other time (even during normal processing). 
For example, you can use it interactively to dump all or specific regions of your job and 
associated system activity. SYSDUMP provides you with a listing that translates the 
state of the operating system when the dump was taken. In the case of a system 
failure, the operating system is shown just as it was at the time of the failure. 


SYSDUMP is made up of two parts: 


e Atranslated dump, which translates the state of the entire operating system into 
charts and text 


e A labeled hexadecimal/character main storage dump 


SYSDUMP is part of the supervisor and is always included at system generation 
(SYSGEN) time. It is designed to be run in a multiprogramming environment. 


To get a system dump, the following two phases must occur: 


1. The supervisor must write an image of main storage to the system dump file 
($Y$DUMP). This phase is called the main storage write phase. 


2. The SYSDMP load module, residing in load library $Y$LOD, must be called in 
and run. It is SYSDMP that reads the $Y$DUMFP file and prints the translated 
and main storage dumps. This phase is called the execution phase. 


Note: The system dump file, $¥$DUMP, does not have to be on the SYSRES disk. It 
can be assigned to any disk. Refer to the Installation Guide (UP-8839) for 
more information. 


Generally, the execution phase of SYSDUMP immediately follows the main storage 
write phase. (The only exception to this is a SYSDUMP obtained from the operator 
controls. For this the operator must call SYSDMP; see 3.2.2.) Because the contents of 
main storage at the time of the main storage write are frozen in $Y$DUMP, you need 
not worry about the execution phase or any other job changing the contents of the 
system dump before you see the listing. This also means that you may use the 
SYSDUMP SAVE and RESTORE options (see 3.2.4) to perform a main storage write 
phase at one site and an execution phase at an entirely different site. 
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The operating system can generate a system dump in response to action by the 
operator, in response to a system error, or upon encountering an error in your job. 


3.2.2. Operator-Initiated SYSDUMP 


You can initiate a dump from either the operator controls or the system 
console/console workstation. Perform Step 1A if you are using the operator controls 
(located on the console workstation); perform Step 1B if you are using the system 
console. 
Note: The handbook referenced in these procedures is the Operations Guide 
(UP-8859). 
Step 1A. Starting from the operator controls 
To initiate the main storage write phase, follow this procedure: 
* For models 3 through 6: 
While pressing the FUNCTION key: 
- Press the D key to place the system in debug mode. 
- Press the RESTART key. 
The dump is completed when the following appears on the screen: 
IPL 


¢ For models 8 through 20: 


- Press the ESCAPE key on the console, then press M (for maintenance). A 
menu appears on the screen. 


- Select L (for system reset) in the menu and transmit. The same screen is 
displayed. 


- Press U (for run), then transmit. (Alternatively, you may press ESCAPE, 
followed by R, a system function.) When the dump is successfully written to 
the $Y$DMP file on disk, the screen shows 99999999 in the bottom right 
corner of the screen. 


- Perform an initial program load (IPL) on the system according to the 
directions in the Operations Guide (UP-8859). 


When the IPL operation is finished, SYSDUMPO (the job stream that runs the 
SYSDMP module) will run automatically. 
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Note: 


After Step 1A, you may get an HPR of 999F. This means that the $Y$DUMP 
file still contains information to be processed by SYSDMP (from a previous 
main storage write operation that has not yot been printed). If this happens, 
you can: 


Print it. - Ordinarily, the information in $Y$DUMP is the system dump 
data most helpful to the Unisys representative who maintains your 
system. To print it, perform another IPL on the system according to the 
procedure in Step 1A. 


Overwrite it. - If you are sure you don't need the information in 
$Y$DUMP, you can write over it with an image of the system’s main 
storage at the time you perform Step 1A. To do this, press 


- The FUNCTION and START console keys for models 3 through 6 


- The letter U and transmit (or the ESCAPE key followed by the letter 
R) for models 8 through 20 


and wait for memory write completion. Perform an IPL on the system 
according to the directions in the Operations Guide (UP-8859). When the 
IPL operation is finished, the SYSDUMPO jobstream will run 
automatically. 


Step 1B. Starting from the system console 


To initiate a dump, key in the following: 


SYSDUMP 


The SYSDUMP command writes main storage to the $Y$DUMP file, then enters a job 
in the job queue, whose only function is to print the system dump. The job is named 
SYSDMPxx, where xx is the unique number assigned to this job by the system. When 
the job is scheduled and run, the following message appears on the system console: 


DUMP OPTION (ALL, NONE, DUMP, JOBS, EDIT, MINI, SAVE, RESTORE) 


See Step 2 for an explanation of these parameters. 


Note: 


After the supervisor writes main storage to $Y$DUMP,, it locks that file until 
job SYSDMPxx is complete. If job SYSDMPxx is removed from the system 
prior to displaying the DUMP OPTION message, you must unlock the 
$Y$DUMP file by entering the following console command: 


SET SY,LOFF 
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Two examples of when this command must be used are the following: 
1. Ifyou delete job SYSDMPxx from the job queue before it is scheduled 


2. Ifthe run processor encounters an error while trying to put job 
SYSDMPxx in the job queue 


Step 2. 


Enter the SYSDUMP command in one of the following three formats, depending on 
the output you want (unless the supervisor has already called it automatically). 


Format 1 


RV SYSDUMP 


Produces an output identical to that produced by running JOB SYSDUMPO with the 
dump option ALL. (See Formats 2 and 3). 


Format 2 
RV SYSDUMPO |, ,DO= / ALL [ vsn [,P=did] 
NONE arene 
DUMP 
JOBS 
EDIT 
MINI 
SAVE 
RESTORE 
Keyword Parameter DO 
DO= f ALL 
NONE 
DUMP 
JOBS 
EDIT 
MINI 
SAVE 
RESTORE 
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Specifies the dump option you want. Available options are: 


LL 
The dump listing displays and translates the state of your entire system, 
including a header page, low-order main storage, the system information 
block, the physical unit block, the main storage map (giving the locations of 
everything in main storage), the system switch list, the job region for each 
job or symbiont in the system, and the free region. Essentially, the ALL 
option combines the DUMP and EDIT options, supplying a hexadecimal 


dump with an English translation. 


NONE 
No output listing is produced. 


DUMP 
Writes the entire main storage in hexadecimal format. 


JOBS 
Produces a hexadecimal dump and a translation for all the jobs, symbionts, 
and shared code in main storage at the time it was written to the $Y$DUMP 
file. 


EDIT 
Provides an English language description of the state of the system. 





Note: EDIT replaces TRANSLATED. Both are supported and they are 
functionally equivalent. 


MINI 
Provides a printed hexadecimal dump, including a table of contents, of 
specific main storage regions dependent upon the HPR or system error code. 


This is the recommended option for dumps to be sent to Unisys for analysis. 


SAVE 
Saves the $Y$DUMP file to magnetic tape or diskette (see 3.2.4). 


RESTORE 
Restores the $Y$DUMP file from magnetic tape or diskette (see 3.2.4). 


If you omit keyword parameter DO or if the supervisor has already called SYSDMP 
(as with the SYSDUMP console command), then the system will display the following 
message: 


DUMP OPTION (ALL, NONE, DUMP, JOBS, EDIT, MINI, SAVE, RESTORE) 
You then enter the one option you want. SYSDMP redisplays this message after 


finishing a SAVE or RESTORE function, so you can perform other SYSDMP 
operations within the same job. 
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Keyword Parameter V 


V= [vsn 
(vsn{,Al, [dev]) 


This parameter allows you to display a dump not residing on the booted SYSRES 
device. 


vsn 
If specified, all data to be processed reside on the specified vsn. If not 
specified, the booted SYSRES is used. 


Indicates that the SYSDMP load module will also be executed from the 
specified vsn. The vsn item must be an alternate SYSRES disk. 


dev 
Indicates that the device number of the disk pack is specified. Use this 
option when you have two volume serial numbers that are the same. 


Keyword Parameter P 


P=did 
If you wish to assign a specific printer as the output device for SYSDUMP, 
enter its 3-character device address using this keyword parameter. You may 
wish to do this if your system supports spooling but you do not want to spool 
the SYSDUMP listing. 


If you want to enter more specifics in the RV SYSDUMPO command, use the 
suboptions shown in Format 3. 
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Format 3 


[,P=did]|, FILE= eee 
(bl name 





RV SYSDUMPO |, ,DO= / ALLE(SYSTEM) ] ,V= [vsn 
NONE (vsn{ ,A],Cdev]) 


DUMP | (NOSHARE) 
(NOBUFFER) 
(CACHE) 
(SYSTEM) 
(SELECT) 


OBS | (NOSHARE) 
(NOBUFFER) 
(SELEC’) 


SAVE 
- RESTORE 


, [FMT= (F {,MLIB=NO]|,SPL= f PRINTER) |[,FOD=NO)] ,BUF= 
fra) me mem ome 
PT=NO 
PI=YES 





Of the Format 3 suboptions, SELECT is mutually exclusive of NOSHARE, 


Note: 
NOBUFFER, CACHE, and SYSTEM. 


Keyword Parameter DO 


Same as in Format 2, except with the following suboptions and options added. 


(NOSHARE) 
Excludes shared code modules in SYSDUMPs. NOSHARE can be used with 
any SYSDUMP option except with SAVE, RESTORE, or SELECT. 


(NOBUFFER) 
Excludes the display of dynamic buffers and the dynamic shared code. 


(CACHE) 
Displays the entire CACHE main storage. If not selected, dump options JOB 


and DUMP will display only 6K of CACHE. 
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(SYSTEM) 
Displays the following preselected regions of the supervisor 


Low Core 

System Information Block (SIB) 

Switch List 

Physical Unit Blocks Table (PUBS) 

Shared Code Directory 

Supervisor Debug Tables 

Supervisor Overlay Area (SOA)/Transient Regions 
System Spool Control Table 


Dynamic Buffer Information Block 





Resident Buffer Control Block 
@ Shared Code Information Block 


(SELECT) 
Allows you to interactively select particular regions of the main storage 
dump. This suboption creates an interactive environment at the operator’s 
console. You will then be prompted to enter requests as follows: 


$D28 SELECT (DISPLAY, JOBNAME ,MEMORY ,REGION,SHARED... 
$D28 . ««.TRANAREA, TERMINATE) 


An abbreviated version of this message: 

$D28  SELECT(DIS, JOB, MEM, REG, SHAR, TRAN, TERM) 
appears after the first selection is made. Thereafter, the complete message 
is displayed only after an incorrect response or when the HELP prompter is 
invoked. 
Note: At any time during entry of SELECT suboptions, you can enter a 


SELECT keyword followed by a blank space, and a help prompter 
for that keyword will appear on screen. 
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You can then enter one of the following keyword requests: 


DISPLAY= 


rtaddr :nn 
X'XxXxxxxxx ' [| [star taddr -endaddr ] 
C'cecccccc! 


sta 
CR 
10 
PR 
RR 
SN 
SR 
JOBS 


OLSPLAY=startaddr :nn 
Displays 1 to 10 lines of main storage on the system console or 1 to 
20 lines on a user workstation, from the start address forward. @ 





JOBNAME= 
MEMORY= 
SHARED= 
TRANAREA= 
REGION= 
TERMINATE 


where: 


Enter a hexadecimal value for startaddr. 


When this keyword is in effect, a blank response results in the next 
logical main storage addresses being displayed. The line count is 
the same as the previous response. 
DISPLAY= | X*xXxxxxxxx!' | [(startaddr -endaddr )] 
eet 
Displays the address of the first occurrence of the sequence 
specified. For the address of the next occurrence, return a blank 
response to the SELECT request with this keyword in effect. 


where: 


XXXXXXXX 
Is a hexadecimal character string of up to 16 bytes. 


cecceccccc 
Is an ASCII character string of up to 16 characters. 
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star taddr -endaddr 
Limits the search for the hexadecimal or ASCII character 
string to the range specified. 


JOBS 
Displays the contents of specified registers. 


where: 

CR 
Represents the control registers. 

10 
Represents the I/O relocation registers 
(models 3 through 6 only). 

PR 
Represents the problem registers. 

RR 
Represents the relocation registers. 

SN 
Represents the snap registers. (Not available on models 
3 through 6.) 

SR 
Represents the supervisor registers. 

JOBS 
Lists the names and addresses of all the jobs in the 
system. 


JOBNAME=job/symbiont-name 
Specifies an 8-character job/symbiont name, which produces a 
hexadecimal dump of that job/symbiont. If you choose the JOB 
option, an English language description is also provided. 
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If there is more than one copy of a job or symbiont, SYSDUMPO 
displays a list of the duplicate jobs or symbionts and their 
addresses. You can then choose the copy you want. For example: 


152SYSDMP76 SD28 SELECT (DIS, JOB,MEM,REG, SHAR, TRAN, TERM) 

15 J=SL$$OWOO 

16 SYSDMP76 SD4@ THERE ARE @@2 COPIES OF SL$$OWOO 

17 SYSDMP76 SD4@ ENTER NUMBER OF DESIRED ADDRESS. (@=NONE) 
182SYSDMP76 SD4@ ENTER 1=@6D10@ 2=076800 

18 1 

192SYSDMP76 SD4@ SELECT (DIS, JOB,MEM,REG, SHAR, TRAN, TERM) 


MEMORY= /startaddr / -endaddr 
,byte-count 


“END 
ALL ,END 


where: 


star taddr -endaddr 
Dumps main storage from the start address to the end 
address specified. Note the use of the dash. Enter 
hexadecimal values for startaddr and endaddr. 





startaddr ,byte-count 
Dumps the number of bytes of main storage specified, 
starting at the address specified. Note the use of the 
comma. Enter a hexadecimal value for startaddr anda 
decimal value for byte-count. 


star taddr -END 
Dumps main storage from the start address to the end of 
machine capacity. Enter a hexadecimal value for 
startaddr. 


startaddr ,END 
Same as startaddr-END. 


ALL 
Dumps all the main storage. 


SHARED=module-name 
Specifies an 8-character shared code module name whose module is 
dumped. 
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TRANAREA= { ALL 
decimal -area-number 
D'ID! 
X'ID! 


where: 


ALL 
Dumps all transient areas. 


decimal -area-number 
Dumps a specified transient area. 


D'ID! 
Decimal ID of the requested transient area. 


X"ID! 
Hexadecimal ID of the requested transient area. 


REGION 


You may enter one of the following acronyms or words designating 
a particular region: 


CACHE 

DBIB 

DEBUG 
DISABLED 
FREE 

ISIB 
LOWCORE 
PUBS 

R8CB 

scbD 

SCIB 

SIB 

SOA 
SUPERVISOR 
SWITCHLIST 
TRACE 
UNIDENTIFIED 


where: 


CACHE 
Cache module and buffers 


DBIB 
Dynamic buffer information block 
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DEBUG 
System debug tables 


DISABLED 
Main storage as disabled 


FREE 
Main storage as free 


ISIB 
Interactive services information block 


LOWCORE 
Main storage from location zero to system information 
block (SIB) 


PUBS 
Physical unit blocks table 


RBCB 
Resident buffer control block 


SCD 
Shared code directory 


SCIB 
Shared code information block 


SIB 
System information block 


SOA 
Supervisor overlay area 


SUPERVISOR 
Dumps the entire supervisor region 


SWITCHLIST 
Switch list 


TRACE 
System trace table 


UNIDENTIFIED 
Unlabeled region of main storage (MEMORY) in synopsis 
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TERMINATE 
Ends the dump session. When a selection has been processed, you 
will always be prompted to enter another selection until you choose 
TERMINATE. A keyword remains in effect until you choose 
TERMINATE. For example, if you select REGION=SIB, you may 
then enter any accepted region acronym without repeating the 
REGION=keyword. 





Keyword Parameter V 

The parameters are defined in Format 2. 
Keyword Parameter P 

The parameters are defined in Format 2. 
Keyword Parameter FILE 


FILE= { $¥$DUMP 
lblname 


where: 


FILE=$Y$DUMP 
This default parameter allows a dump image to be processed from system 
file $Y$DUMP. 


FILE=(blname 
Allows a dump image to be processed from some file other than system file 
$Y$DUMP. 


Keyword Parameter FMT 


te! 


where: 


FMT=F 
Provides a full System Maintenance Change (SMC) listing after the dump. 


FMT=C 
Provides a condensed SMC listing after the dump. (This is the default.) 
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Keyword Parameter PT 


PT=NO 
_PISYES 
where: 
PT=NO 
System Maintenance Change (SMC) listing is not printed. If this is entered, 
you cannot specify any FMT. 
PT=YES 
SMC listing is printed. If nothing else is specified (FMT or PT=NO), this is 
the default. 
Keyword Parameter MLIB 


MLIB=NO 
Prevents dumping of the $Y$SDF file. 


Keyword Parameter SPL 
SPL= | | 
TAPE 


where: 


SPL=PRINTER 
Sends all spooled output to the printer. (This is the default.) 


SPL=TAPE 
Sends all spooled output to tape. If this is not specified, then output is 
printed. 
Keyword Parameter FDD 


FDD=NO 
Turns off printing of the FDDO diskette. 


BUF=NO 
Turns off printing of the dynamic buffer summary. 


BUF=YES 
Turns on printing of the dynamic buffer summary. (This is the default.) 


Table 3-1 is a summary of the run statement keywords. 
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Keyword 
Parameter 


DO 
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Table 3-1. Run Statement Keyword 


joe | oot 
a NOSHARE DO=DUNOS) 
Co NOBUFFER DO=DU(NOB) 
a CACHE DO=DUICAC) 
ed SYSTEM DO=DUSYS) 
4 SELECT DO=DUSEL) 
aa NOSHARE DO=JO{NOS) 
ae NOBUFFER DO=JO(NOB) 
toe SELECT DO=JO(SEL) 
ee ee V=(vsn1,Al, [dev]) 


continued 
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Table 3-1. Run Statement Keywords (cont.) 








Parameter Suboption Format 

FILE jsvsowrt | FILE=SYSDUMP 
ftomame | FILE=IbIname 

SPL jeanmer’ | | SPL=PRINTER 

FDD | FDD=N 

BUF BUF=N 

" Default 


3.2.3. Supervisor-Initiated SYSDUMP 


The supervisor will automatically generate a system dump in either of two situations: 
e An error occurs within a user program. 
e An error occurs within the supervisor itself. 


These two situations are discussed in more detail in 3.2.4. 


SYSDUMP from User Program Errors 


You can enable the supervisor to generate a SYSDUMP if it encounters a program 
error or the program executes either the DUMP or CANCEL macroinstruction. In this 
case, the main storage write phase and execution phases are called and executed 
automatically, one after the other. To accomplish this, the supervisor calls and 
executes the SYSDMP load module in your job region within the same step in which 
the program error occurred. 
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To enable a supervisor-initiated SYSDUMP you must: 





e Include a printer device assignment set with the LFD name PRNTR 


¢ Include //AOPTION SYSDUMP job control statement preceding the //AEXEC 
statement of the program for which the dump is to be taken 


If you want to enable the SYSDUMP option for more than one step, use the // OPTION 
GSYSDUMP job control statement. Inserting it in your control stream enables the 
SYSDUMP option for all steps following it right up to the end of the job. 


If you want to restart a job while OPTION SYSDUMP is still processing, use the 

// OPTION PSYSDUMP job control statement. This option immediately terminates 
the failing job and processes the OPTION PSYSDUMP under a cover name of 
JOBNAME#. 


If a program run with //AOPTION SYSDUMFP fails, the supervisor will write a main 
storage image to $Y$DUMP, load the SYSDMP module for the execution phase, then 
display the following message: 


DUMP OPTION (ALL, NONE, DUMP, TRANSLATED, JOBS, RESTORE, SAVE) 


You may want to tell the system operator beforehand what SYSDUMP option to enter 
should a system dump be generated from your program. See Step 2 in 3.2.2 for an 
explanation of these options. 


SYSDUMP from System Errors 


Some system errors (errors occurring within the supervisor) may automatically 
initiate a SYSDUMP. The supervisor will attempt to write a main storage image to 
$Y$DUMP;; if it succeeds, an SE15 message will be displayed on the system console, as 
in the following example: 


SE15 SYSTEM ERROR 2@ IN TRANS # 33-SYSDUMP WRITTEN TO DISK 


The system will then schedule job SYSDMPxx to print the contents of $Y$DUMP. 
This example of message SE15 shows that a program check (error code 20) occurred in 
transient number 33. The SYSDUMP WRITTEN TO DISK message indicates that job 
SYSDMPxx has been scheduled. When you see the DUMP OPTION message, you 
should reply with the DUMP, MINI, or SAVE option, and send the resulting printout 
to your Unisys representative for analysis. 
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If the $Y$DUMP file is in use or locked when a system error occurs, a SE16 message 
will be displayed on the console showing the error and the current contents of the 
program status word (PSW) and registers. In this case, no main storage write will be 
performed. The system will, however, continue to run. 


3.2.4. SYSDUMP SAVE and RESTORE Options 


The end product of a SYSDUMP is the printed listing that shows the state of the 
operating system and user jobs at the time the system crashed. For analysis purposes 
you may wish to send a SYSDUMP listing to another site. The size and bulk of a 
printed listing, however, may make sending it a slow and expensive process. To help 
you avoid this problem, Unisys provides the SAVE and RESTORE options with 
SYSDUMP. You may use the SAVE option to copy the $Y$DUMP file to diskettes or a 
magnetic tape volume. With the RESTORE option you copy the data on that diskette 
or tape back onto the $Y$DUMP file. This means, for example, that at one site you 
can copy a $Y$DUMP file to a diskette (with SAVE), send only the diskette to another 
site, copy the diskette data to the $Y$DUMP file there (with RESTORE), and run 
SYSDUMPO to get the printed listing of the dump, all at reduced cost and in less 
time. 


You can use the SAVE and RESTORE options with single and multivolume tapes and 
diskettes; however, there are some requirements. 


e Tape 
- Requires Consolidated Data Management (CDM) 
- Requires 9-track tape 

¢ Diskette 


- Requires Consolidated Data Management 


SAVE Option 
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To use the SAVE option you must first prep a diskette or magnetic tape using the 
canned job control stream SD$PREP. When you call SYSDUMPO and get the DUMP 
OPTION message, you key in SAVE. The system will reply with the following console 
message: 


ENTER DUMP DEVICE INFORMATION (DISKETTE, TAPE, NONE) 
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Key in the device you will use in saving the $Y$DUMP file, DISKETTE or TAPE, or 
key in NONE to terminate SAVE without saving the $Y$DUMP file. If you enter 
DISKETTE or TAPE, the system will then ask you to mount a prepped diskette or 
magnetic tape on an unused drive. When you have done so, the system will copy the 
$Y$DUMP file. After it finishes it will display: 


SYSDUMP SAVED ON TO { TAPE 
DISKETTE 


The system will then display the DUMP OPTION message so that you may select 
another SYSDUMPO option or terminate SYSDUMPO altogether (with NONE). In 
other words, when you ran SYSDUMPO with the SAVE option, you will be assigning a 
diskette/tape in addition to supplying a brief “problem description". 


You can send tapes containing saved dumps to the Customer Support Center for 
analysis. Please include the following on the label of the tape: 


¢ Whether or not the system that created the tape was generated for tape block 
numbering 





e Streaming or non-streaming type of the tape drive 
¢ Your company name 
© e Applicable reference number 
- UCF number (supplied by Unisys) 
- Authorization number (supplied by Unisys) 
e Date 


¢ Number multivolume tapes giving the number of the tapes and the total number 
of tapes (for example: 1 of 3, 2 of 3, 3 of 3) 


e The dump name (please note on UCF form in comments area), for example, 
HENRC001 


Note: TheSYSDUMP will print the SMC LIST and error log. Include these listings 
with the tape or tapes. 
RESTORE Option 
You use the RESTORE option much like the SAVE option. In response to the 
SYSDUMPO DUMP OPTION message you key in RESTORE. The system will reply 


with the following console message: 


& ENTER DUMP DEVICE INFORMATION (DISKETTE, TAPE, NONE) 
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Key in the device type that contains the saved $Y$DUMP file, DISKETTE or TAPE, or 
key in NONE to terminate RESTORE without restoring the $Y$DUMP file. If you 
enter DISKETTE or TAPE, the system will then ask you to mount the magnetic tape 
or diskette. When you have done so, the system will copy the data to the $Y$DUMP 
on the SYSRES volume, destroying any data previously stored there. After it finishes, 
it will display: 





SYSDUMP RESTORED FROM | TAPE 
DISKETTE 


The system will then display the DUMP OPTION message so that you may select 
another SYSDUMPO option or terminate SYSDUMPO altogether (with NONE). You 
can now have the system print the SYSDUMP listing in any of its available formats. 


Note: When the SYSDUMP main storage write and execution phases take place in 
the same system, the main storage map will include a list of the CSECTs in 
main storage. If you run SYSDUMPO on a system other than the one whose 
main storage image is in the $Y$DUMP file, you will not get the CSECT 
listing. All other parts of the SYSDUMP listing, however, will be printed. 


Prepping a Diskette or Magnetic Tape for SAVE/RESTORE 


Before you can use a diskette or magnetic tape with the SAVE or RESTORE options, 
you must prep it using the canned job control stream SD$PREP. The control stream 
accepts a diskette or magnetic tape straight from the factory, formats it if necessary, 
and allocates a single-volume file called $Y$DMP, the file which the SAVE and 
RESTORE options use. 





Note: If you send a dump on tape to the Customer Support Center, make sure 
another tape is prepped and ready for future dumps. 


To call SD$PREP, key in: 
RV SDSPREP, , TYPE= { TAPE ,NUMBER= { 1 pete pee i 
DISKETTE nn vv 2 
where: 


TYPE= | TAPE 
DISKETTE 


Specifies the type of device to be prepped. 


NUMBER= q 
nn 


nn specifies 01 to 16 tape or diskette volumes. 
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VOLUME= 4 | 
VV 


w specifies the first volume to be prepped. 
SIDES= { 4 
2 
Specifies a 1- or 2-sided diskette. 


The system will ask you to mount the diskette or magnetic tape to be prepped. When 
you have done so, the system preps it. 


These are a few things to remember when using SD$PREP: 


1. Prepping a magnetic tape or diskette for SYSDUMPO destroys all data 
previously recorded on that medium. 


2. Adiskette or magnetic tape prepped by SD$PREP cannot be used for other files 
or programs. To use a magnetic tape or diskette (for other files) that has already 
been prepped with SD$PREP, you must prep it again using the appropriate 
system service program described in the System Service Programs (SSP) 
Operating Guide (UP-8841). 


3. Tapes or diskettes prepped prior to Release 8 are no longer valid. 


3.3. Job Dump Routine (JOBDUMP) 


You use the job dump routines JOBDUMP and ABRDUMP to determine what caused 
your job to terminate abnormally. 


3.3.1. Full Job Dump (OPTION JOBDUMP) 
JOBDUMP provides a method for determining what caused the job to terminate 
abnormally. It prints out a listing of the state of the job region when the job crashed. 
JOBDUMP is made up of two parts: 
¢ Adump that translates the state of the job region into charts and text 


e A labeled hexadecimal/character main storage dump 
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To execute JOBDUMP, a // OPTION JOBDUMP job control statement is required and 
must precede the EXEC job control statement. The first statement invokes 
JOBDUMP if the job terminates abnormally or upon execution of a DUMP or 
CANCEL macroinstruction in the assembler program. 


There must also be a printer device assignment present in the control stream with a 
LFD file name of PRNTR. 


3.3.2. Abbreviated Job Dump (OPTION ABRDUMP) 


The abbreviated job dump provides you with a shortened listing of the full job dump to 
help you determine what caused the job to terminate abnormally. When ABRDUMP 
is called, only the area in the vicinity of the last instruction executed, along with the 
address and contents of the I/O buffers associated with the OPEN DTFs, is printed. 


To execute ABRDUMP, a // OPTION ABRDUMP job control statement is used in place 
of the // OPTION JOBDUMP job control statement. The abbreviated job dump is 
called similarly to the full job dump. 


3.4. EOJ Dump Routine 





macro in your assembler program or by an abnormal termination of your job. In either 
case, the // OPTION DUMP job control statement must be present in your control 
stream. The EOJ is in hexadecimal format and is divided into four sections: problem 
program registers, job preamble, task control blocks (TCBs), and your program region. 
In addition, the dump also gives you the PSW at interrupt time, the error code that 
caused the abnormal termination, and the next TCB address. 


The EOJ dump routine is called by either the DUMP macro used in place of the EOJ @ 


3.5. Supervisor Trace Analysis 


The supervisor trace facility is automatically included in any system dump, whether 
operator- or supervisor-initiated; you don’t need to activate it. 


The module for the supervisor trace facility is SM$TRACE. 


3.5.1. How to Read a Supervisor Trace 
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1. Find the module heading SM$TRACE in the system dump printout. It should be 
located near the end of the resident supervisor portion of the dump. 


2. Find the word TRAC in the interpreted (edited) section on the right side of the 
system dump printout. 





UP-9980 Rev. 1 





OS/3 Dumps 


3. Now find the equivalent of TRAC in the hexadecimal portion of the printout. 
This hex value marks the beginning of the trace table where the supervisor 
activities are logged. 


Note that the entry for each supervisor activity consists of four hexadecimal 
words. The supervisor trace table can contain up to 400 entries and will wrap 
(overwrite the beginning of the table) when the end of the table is reached, so that 
only the 400 most current entries are listed. 


4. Find the word following the hex equivalent of TRAC. This word contains the 
address of the next available entry in the table (i.e., where the next entry will be 
logged). 





5. Look for this address in the hex portion of the printout. Note the entry in front of 
this address. This entry is the last (most current) one logged; it is the logical end 
of the supervisor trace table. 


Table 3-2 describes the supervisor area trace table entry formats. Note that word 1 
for each entry appears in the interpreted portion at the right of the dump printout. 


Table 3-2 also provides the interpretations of the hex values of words 2, 3, and 4 for 
each supervisor area. Note that all zeros indicate that there are no values (no entries 
to be made) for that word. In some cases, words 2 and 3 are combined to provide one 


& value. 
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Table 3-2. Supervisor Area Trace Table Entry Formats 










Supervisor Word 1 Word 2 Word 3 Word 4 
Area 

Timer 80000000 02000000 Interval 
timer 

register 

Machine Machine check old Interval 
check program status timer 

word (PSW) register 

Program PC Program check old Interval 
check PSW timer 

register 

Transient TO Transient Overlay Interval 
overlay area transient timer 

address id register 

Task switch Ts 00000000 TCB Interval 
address of timer 

new task register 








SVC call SV Interval 
SVC old PSW timer 
register 
Transient TR Transient Transient Interval 
release area id timer 
address register 
Shared sc TCB address Name of Interval 
code call of task shared code timer 
using shared | module being register 
code called 
Shared TCB address Name of Interval 
code release of task shared code timer 
using shared | module being register 
code exited 
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Sample Dump Analyses 


4.1. General 


In the preceding sections, you got a general overview of OS/3 dumps and of how OS/3 
interacts with user programs. In this section, you will see examples of dump analyses 
applied to actual user programs by using the ideas already presented. A number of 
programs are shown here that have failed while being executed. Although all have 
been compiled or assembled correctly, errors have nonetheless remained. It is in 
uncovering these errors that dump analysis is a useful tool. 


Three programs are presented in this section, each written in a language supported by 
OS/3: 


¢ BALOBd, a program that reads data from cards, adds the data, and outputs the 
result to a printer, is written in Basic Assembler Language (BAL). 


¢ COBOBU, a program that performs the same functions as BALOBJ, is written in 


& COBOL. 


¢ RPGOBJ, a program that performs the same functions as BALOBg, is written in 
RPG II. 


In these examples, you will be working with different types of dumps, as well as with 
other diagnostic tools supplied with the individual language processors. Each 
example takes the following form: 

e An outline of the program and the circumstances under which it failed 

¢ A list of the dumps and other materials used in the analysis 

¢ = Abrief outline of the particular type of dump used or of an analysis technique 


e  Astep-by-step dump analysis narrative 


e An edited copy of the output listings used in the analysis 
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The dump analysis itself will consist of two parts; the narrative and the listings. Most 
important among these listings is the dump itself, but compiler/assembler listings and 
other materials are also included where needed. 


In a typical dump analysis, you will move forward and backward within and often 
outside the dump. With analysis, you are trying to uncover the logical (and not 
necessarily the physical) sequence of events leading up to a program failure. 


To help you find your way through the following analyses, they are broken down into 
logical steps numbered @ , @ , @), etc. With each step, a relevant portion of the 
listings is reproduced within which an identically numbered pointer indicates the data 
used in that step. All the pointers reappear in the listings themselves, together with 
an index indicating where each pointer is. 


As an example, we show two excerpts from a dump analysis, one taken from the 
narrative and the other from the output listings. 


Dump Analysis Narrative 


(9) 


POCIAI-DOGTYOON DODONGOG GOVOYODOD NODODONG OOODDGOD OOONDOON FZFSFZ40 FIEFSHS| CooccovecccccccnccsscceeeZ32 365 -001890 
COOICO-AOSDOZCS D3IOSCSES GBSNESDE DAOSUNT FOSOSLAD SONNKNAD SUSOSUND AONTADND © KELLEY, TOR 001880 


COOLEC-FIFOF 389 SOF3FOF2 SNSNESC? DSC3CSOS E36BRLC? CSDED9C? CS8O808C S0adelan F1N3 342 VINCENT, GEORGE -003600 





At location 18AD @) we see that the three bytes operated on by the PACK 
instruction... 


Dump Analysis Output Listing 


QBODEG-OCODIALF DOOUDBFO JIINO%VO NOOOOTZS COCUNGIB J2LO1SDO TWHO0IGZB DIZ889IN FevccceeNevcccccvccccesevecccscee Ol IDI 
OOCRW-82U8GSO% OOZ80000 OFUDI8AB BONOOUDO NOOQOACO UNCIOCOO WUIDOUNO ANZTONOC FecccceccnccvccesesccvccesecoveceO0l FFD 


000120-0000u009 OVOODTND BFOOVOLO HOOUOOCO COTO8LEB JOLIONUON DONCNONG UMOOIBSC Savecevcccevcccecccccccesescccce*—I01810 








999190-00001886 CO0D00IU VCOD08O7 O7O9COCS9 N3CS9O8D BOLOODSS PODGNOOG GODOOSE® SeccvcccccvecPRFILE ceoovececeoel=O01830 


se coccccccccccsecccccscces cosse 001850 


C3C160-F 1290009 CO909000 GNvNLESS 01901920 O0009026 ONzcaser IC8Bsuoa OOZBLOO (9) 








300160-02G018F8 NOQVODOV DOGOUTLO DOOLIGNY CODGOOOU LOLIDOOL WOGOONG UOUDCNOD .oBeccccccccccerccccccsccccecse—OOI870 
POPIAI-DOO"O0ON COOONECO OOUOVOND NUNODDDG HONONGOD ONONDOON FZF3FZ90 FH EFS6O] Pecccacccccccccvccseseesdz3z] 465] -001890 
COOICO-SO8002CS O3D3C5SEB GBSDE3DS DSSDSUSD SOSOSLNO SDSD8NSO SUSORUAD S08NNORl © KELLEY, TON " ~001880 


COOQLEC-FIFOF389 SOFSFOFZ S°RNDESCO OSC3CSOS ES6BSLC?T CSOGD9C7 CS8G808G 8O8DeleD 413 362 VINCENT, GEORGE (11) -001800 





42 UP-9980 Rev. 1 











4.2. 


4.2.1. 


4.2.2. 


Dump Analyses 


These analyses assume that you have a knowledge of machine language, especially 
main storage addressing. If you need to learn about how machine instructions in 
general are executed, refer to the appropriate processor programmer reference. To 
learn what an individual machine instruction does, refer to the Hardware and 
Software Programming Quick-Reference Guide (UP-8868). 


BAL Dump Analysis 


In this subsection, we will analyze an EOJ dump generated from a BAL program 
called BALOBJ. We will use some of the TCB fields discussed earlier to help uncover 
the error causing the dump. 


Program BALOBJ, run as part of a job named BALJOB, reads numeric data from an 
input card, adds the numbers, and outputs them to a printer together with a copy of a 
character string punched on the input card. The program as written is assembled 
without any errors, but when we run it, it fails, generating an error code of 20-a 
program exception. Anticipating the possibility of such an error, we have put an 

// OPTION DUMP card in the JCL runstream immediately preceding the EXEC 
instruction that loads and runs BALOBJ. The program exception causes the 
operating system to dump the job area containing BALOBJ; because the EOJ dump 
goes directly to the user’s log file, there is no need to assign a printer exclusively to the 
dump. 


Materials Used 


The materials we will use in the analysis are contained in 4.2.4. They include the 
following as shown in Figure 4-2: 


¢ The BAL source code for BALOBJ 
¢ The linkage editor allocation map 


¢ The EOJ dump, edited for clarity 


Outline of EOJ Dump 


We will use the step-pointer system outlined in 4.1 to help guide our way around the 
output listings shown in 4.2.4. An important part of using this system is knowing how 
the EOJ dump is organized. You should compare the examples and chart presented 
here with the actual dump shown in 4.2.4. 
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A portion of a typical EOJ dump looks like this: 


JOB-RELATIVE ABSOLUTE 
ADDRESSES ADDRESSES 


FrFrree 80800305 DS2CSCsE3 FOFODZ00 son000zB FFFFFTC® o000Cc1I0 FFFFFSFS Mceosono o1pses 
FFFFAS GHo0209E0 B0600000 aooonnnn 00000240 e€09000ci BEO0190 OntIBeoo «NOON 37 O1BSaa 
FFFFCS c7e20000 ocetonobe onf00000 ssFonnnE l2FF8SFO HOCOssTsG ) «6FOl8SsSsFO 6NOoneseFo aisscs 
FFFFES FOOSOTFF 9S00FO28 8780FO22 OasSessFO FO2Z807FF OOGFEASSS O1BSEB 


PReGRAN REGION 
aoococ OFO20 S8O08FOF? s228N000 fooR00NG oocooneno sececon0 s00LUroeD § fonuroos O1geon 


ooo02zc (91901088 8780FO30 SOD0I0Ss Seddlross SOECDOCC SUEQDOIU SIAOFSOE SIRLFS9E orpe2r 


900080 92001032 91%010%6 S8710FOS@ 92131038 96N21032 ATFB91I02 10460718 95201031 Olpese 


LOCATION 
000000 


As you can see, each line of the dump contains 32 bytes of data. The location of that 
data is given by the two addresses flanking each line. Both addresses always refer to 
the hexadecimal location of the first byte in the line but differ in their addressing: the 
right-hand address is the address of the location relative to the entire system, while 
the left-hand address is relative to the program region. Since the job prologue comes 
before the program region, its left-hand addresses are given as negative (twos 
complement) values. 





The characteristics of the EOJ dump are summarized in Figure 4-1. 
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LEFT CONTENTS RIGHT 
MARGIN MARGIN 
ADDRESSES ADDRESSES 
RESIDENT SUPERVISOR 000000 
000020 
e 
(OTHER JOBS) 
PREAMBLE 
TCBs 
PROLOGUE 
TABLES 
eas nea MAIN STORAGE 
16 SHOWN IN 
Hate, 2 ee gh ee A oes ee ee “— ~~ | EOJ DUMP 
000000 
000020 
PROGRAM 
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Figure 4-1. EOJ Dump Organization 


As Figure 4-1 shows, the EOJ dump presents the entire job region, broken up into a 
number of blocks: the preamble, each TCB, other prologue tables, and the program 
region. To read and analyze an EOJ dump, you will need to know about the structure 
of the TCB, discussed earlier in this manual. As we go through the following analysis 
you may want to review 2.2 for the structure of the TCB. 
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Not shown in Figure 4-1 are several other items that are present at the beginning of 
the EOJ dump: 


¢ Jobname 


e System version 


¢ PSW at the time the program failed 


e Error code 


e Address of the TCB that was active when the program failed 


¢ Contents of problem registers 0 through 15 when the program failed 


4.2.3. Analysis 


To determine what caused program BALOBgJ to fail, we proceed as follows: 






tess 
FFFSOO 
FFFS20 
FFFSa0 
FFFS60 
FFFS8O 
FFFSAD 
FFFSCO 


PsuNT IMvERRuPt 


1001 4800 


oooo0000 
deco0000 
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09000000 


00000300 
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so0000000 
0ase0020 
ooco0000 
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20014800 
odoootoco 
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o0000c00 
ecooco00 
oo000000 
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eoo00000 
fo0c0000 
coteo00e 
coooco0a 


ermen CODE = 00000020 


OOOOF 22a 
nuxocooo 
acdoca0o 
ocoo0000 
8000149B8A 
®coo000a 


N0014a00 
nooococe 
ooooca00 
noooooro 
codorota 
coocno00 


Tee aoor = [OTAbOO) 
1coco900 NoooneNG [ol ABon] 


myoooooo 0009000 oOfaB2n 





90001892 = Noncoono Oraban 
oonocaoe fonunono OLAB6S 
01862800 Acs8190N0 OLABBD 
epoo0o0ce fonoco0d Otaspar 


02 a8co 


We begin by looking for the instruction that directly caused the failure of the program. 
The TCB at location 1AB00,, is the primary TCB for the job; therefore, its PSW save 
area (offset 20,,-27,,) M holds the PSW at the time of the error. 
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Let’s look more closely at the task PSW. Using the PSW illustration in 2.1.1, we can 
extract the following information: 


C016 00 


BINARY INSTRUCTION 
1000 ADDRESS 
ets INSTRUCTION LENGTH CODE 
(SPECIFICATION 3 poet ones 
EXCEPTION) 


From this PSW, we can determine where the error occurred and what caused it. We 
find the error location by remembering that all interrupt handlers store the address of 
the next instruction to be processed in bits 48-63 of the PSW. The length of the 
instruction being processed at interrupt time is stored in bits 32-33. From this 
information, we can find the address of the instruction causing the interrupt: 


14BA  PSW instruction address 
- 4 ILC (= 2 half words) 
14B6 _— Address of instruction causing interrupt 


As to what caused the interrupt, we can determine that from bits 24-31, the interrupt 
code. In our case, the code is 06, which, according to Table A-1, is a specification 
exception involving the improper use of the instruction at 14B6. 






PURSE NAME TRANS ADDR 


LaseL TYPE €sio LwK ORG HIADOR LENGTH OBS ORG 
200 END OF AUTO-INCLUDED ELEMENTS \- 





= 19709707 22.11 - BALOBJCT _ of 
DFIC NTRY 01 o00 G hale Tt) 
COFILEC Entey 01 00001582 NoounnB2 
COFILEE EWTRY 01 00001588 nooor ope 
PRFILE Entry 01 0000158 NoOo0aF O 
PRFILEc ENTRY 01 00001582 0000122 
PREILEE EWTRY 01 oo001s88 no00n128 


To use the information we have so far, we will need to find the instruction that caused 
BALOBJ to fail. Keep in mind that a load module like the one loaded and run in this 
job can comprise one or more object modules like BALOBJ, bound together by the 
linkage editor. We can use the linkage editor allocation map to determine in what 
portion of the load module our failing instruction lies. 
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Pointer @ indicates an entry on the allocation map. Three items of the entry are of 
interest to us: the label BALOBJ, the LNKORG address 1490, and the HIADDR 
address 168F. The LNKORG and HIADDR addresses define the boundaries of the 
object module named BALOBJ and we see that address 14B6, indicated by @ , lies 
within BALOBJ. The exact location of the address can be determined as follows: 


14B6 = Address of failing instruction in load module 
-1490 LNKORG address (first address of BALOBJ) 
26 = Offset of failing instruction within BALOBJ 










GoooICc 9280 C18C 0o01BC avi PROUFF,C® °* CLEAR OUTPUT BUFFER. 
000020 0226 Cigp-TiBC 001B0 oCO1BC mvc PRBUF F +1439) PRBUFF 
6ET COFILE ,COBUFF READ INPUT RECORD. 










o00026 A 6170 CveN) SET ALIGNMENT 6ETO0230 
(O00026] $810 C1IFO OO1FO A 18% LOAD R1$_ FILENAME ADDRESS GETON260 
S000 $800 CiFa OO1FS A 194 Lt 9 DB UI LOAD ROS, WORKAREA ADDRESS 6€T00850 
GQooOzE 9210 103: 0003) A 20 aVI @9(29,R°10"° SET FUNCTION CODE GETOLOIO 


We now know that the failing instruction we seek does lie within our BAL program, 
rather than within one of the other object modules making up our load module. We 
turn to the assembler listing for program BALOBJ and look at offset 26), @), the 
instruction location calculated in @). We find there that our failing instruction is one 
that LOADs register 1 from a storage location determined by base register 12 (C,,) 
and offset 1F0,,. Looking at Table A-1 for possible causes of our error, we see that the 
most likely explanation is that the LOAD does not refer to a proper boundary. LOAD 
instructions can operate only on data residing on full-word boundaries; might the 
main storage location given by @) not satisfy this requirement? To see, we go to @, 
located at the beginning of the EOJ dump. 





PROBLEM PROGRAR RECS 
REGS 0-7 90000000 80001898 on00D0000 xcN000000 Ococooto Ag00c08H seoocene § HonOnotO 


REGS 8-F 00090000 deG00000 coDn00D0 soD00000 fo0000r0 cooDCOnD NosOrOND 
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To find the storage location referred to by the LOAD instruction in @) , we must first 
find what is in base register 12 @ . Ignoring the high-order byte, which plays no part 
in address formation, we see that register 12 contains the value 1492. Once again, the 
instruction in @) is: 


5810 C1F0 
The storage location is determined as follows: 


1492 Register 12 contents 
+1FQ Displacement 
1682 Referenced main storage location 


Location 1682 does not lie on a full-word boundary; therefore, any LOAD instruction 
referencing it will generate a program exception like the one that has occurred in this 
program. 


One question remains: why does the main storage location fail to lie on a full-word 
boundary? As @) shows, the location is represented by an address constant (for 

CDFILE) and address constants are assembled on full-word boundaries. For more 
clues, we will have to look backwards in the program to see what events could have 


disrupted it. 
000000 ; Barosuct iaet 
ss“ 
oo00te 3 6) Using BALonact 12 

oY ry OPEN FILES. 

oone02 o700 A Se CNOP aed OPE 00130 
cocons ae co10 00010 A 6¢ BAL 1,9¢¢ge3) opeaosoo 
oocoos F a Te oc x*FO? OPEOOs8sO 
o00009 peoeso A Be oc AL SECOFILED oPpe00600 
cooooc so A Ge oc x°80 orpeo0s SO 
000000 O0D0FD A 10¢ oc pi poorny oPpe—oo6o00 
pO0010 OAz6 a Ale svc 38 ISSUE SVC opeooso0 
000012 9280 C198 001989 12 Loop nv COBUFF,c* *° CLEaR INPUT BUFFER. 
000016 0226 CI95 C194 moth 00194 13 ave SPeUEE cere crt ee 
000G1C 9290 C1BC 1s avi PReUFF,C CLEAR OUTPUT BUFFER. 







000020 0226 CiBO CiBCc DO1BD 0018¢ mvc PRBUF FS] 039) ,PRAUFF 

GET COFILE ,COBUFF READ YNPUT RECORD. 

oc wn SET ALIGNMENT 6ETOO2Z30 
Cy 


LED} LOAD RIS, FILENAME ADDRESS GETON260 





A 
GO1LFO A 





Looking at @ again, we see that the displacement 1F0,, is evenly divisible by 4. For 
a full-word location, the value contained in register 12 must also be evenly divisible by 
4, As @ shows us, however, the register 12 value of 1492 is not. So we look at 
previous instructions affecting register 12 and find at © a BALR instruction and a 
USING directive. 
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4.2.4. 


410 


The USING directive marks the location of symbol BALOBJ as the base address for 
this assembly and names register 12 as the base register. Since BALOBJ occupies 
location 00 (1490 when linked into the load module), all references to main storage use 
register 12, presuming it has a value of 0. However, the previous instruction at ©), 
BALR 12,0 effectively loads a value of 2 (in fact, a load module-relative address of 
1492) into register 12. Since the BALR instruction takes effect only at execution time, 
it introduces a 2-byte address offset that was never taken into account by the 
assembler. This unexpected offset causes the LOAD instruction in @) to try to access a 
main storage location that is not on a full-word boundary. The result is the 
specification exception that caused BALOBg to fail. 


The solution to the problem is to rearrange or rewrite those introductory BAL 
statements in ©). One correct sequence is: 


BALOBU START @ 
BALR 12, 
USING *, 12 


We should note that the statements at @) and © were assembled without error. It 
was only after they were executed that a problem emerged. We should also note by & 
looking at Figure 4-2 that the steps we take to analyze BALOBJ follow a logical, not a 

physical, sequence - step © lies above @) , for example. It is the time sequence that 

we are most concerned with, and the EOJ dump can be helpful to us in that respect. 





Dump Analysis Materials 


The edited printout from job BALJOB, including the assembler listing for program 
BALOBJ, the link edit, and the EOJ dump are contained in Figure 4-2. All the 
pointers referred to in 4.2.3 are shown in the list below in numerical order, each 
pointer referring to the part of Figure 4-2 on which it appears. Use this list to assist 
you in looking for these pointers. 
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Figure 4-2. BAL Dump Analysis Listing (Part 3 of 7) 
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PAGE I 
ROC. OBJECT CODE ADOR] ADOR2 LINE SOURCE STATEMENT 0S/3 ASM 79/0907 
000000 1 BALOBS START & 
oocooa Osco 2 BAUR 12,0 
cooono 3 USING BALOBJ,12 
8 w oPRFILE OPEN FILES. 
oooo02 o700 A 5¢ CNOP Ly4 ope oo1s0 
000008 9510 cu10 00010 A 6¢ BAL 1,9¢0983) oPtoesoo 
cocoos FO A Te oc x°FO° ereoo0sed 
oo0009 of0080 A Be oc AL3ECOFILED oPe00600 
conooc 80 A Ge oc xrene Pees sO 
oooo00 ONcOFD A 10 oc ALZ(PRFILED orPe00600 
000010 DAZ6 A lie SVC 38 ISSUE SVC orpeooe00 
000012 9290 C198 to198 12 Loop MVI «ss COBUFF,Cc* ° CLEAR INPUT BUFFER, 
000016 D226 C195 C19% 00195 00194 13 MVC) |= COBUF F*1¢39),COBUFF 
oocolc 9299 C1BC 001BC 18 MVI = PREUFF,C® °* CLEAR OUTPUT BUFFER. 
000020 0226 C180 CIBC 301BD 001BC 15 MVC «=- PRBUF F #1039) ,PRBUFF 
16 GET COFILE,COBUFF READ INPUT RECORD. 
oo0026 i oc CVEN) SET ALIGNMENT 6ET00230 
COlFD A 18% LOAD R18, FILENAME ADDRESS 6ETON260 
CooozA 5800 CiF® OOIF® A 19¢ C = DBU LOAD R"%, WORKAREA ADDRESS 6eToesso 
O0002E 9210 1031 o00c31 A 20° VI a9(1),X°10* SET’ FUNCTION CODE 6ETO1OIO 
coco32 58FO 1038 00034 A 21¢ t 15,52¢,1) LOAD ADDR OF COMMON 170 GETO1020 
000036 OSEF & 226 BALR 18,15 LINK TO COMMON GETOI030 
Coco38 F222 CiES CI9S COIES® 00198 23 PACK PADO1(3),A0D103) CONVERT 1ST NUM TO PACKED DFC. 
OOCOSE F222 C1ET C199 OOIE7 90199 25 PACK PADD2(3),A0D203> CONVERT 2ND NUM TO PACKED DEC. 
000088 Fa22 CLEY CIES NOIET OOLES 25 ap PADDZ(3),PADD14E3) ADO NUMBERS. 
OOOOSA F332 C1BC C1E7 CO1BC CO1E? 26 UNPK SUMNC%),PADD203) CONVERT su®@ TO FBCOIC. 
NoooSO 96FO C1BF 2U1BF 27 or SUM+3,X°FL® MAKE LOW-ORDER DIGIT PRINTARLE. 
000058 D21D C1IC3 CIDE BOIC3 CUISE 28 MVC) «= RAME QUT C30) ,NAMEIN MOVE CHARACTER STRING TO OUTPUT 
29 PUT = PRFILE»PRBUFF WRITE OUTPUT RECORD 
COOOSA A 3Me oc CY¥CO) SET ALIGNMENT 6ET00230 
CODOSA 5819 C1FS COIF8 A 31¢ L 1,=AQUPRFILE? LOAD RIS, FILENAME ADDRESS 6ETO0260 
OOfmOSE 5800 C1FC QUIFC A 326 L Cy=ACPRBUFFS LOAD ROS, WORKAREA ADDRESS 6€ 100850 
000062 9220 1031 30031 A 336 MVI «—- ©9410 ,K°20* SET FUNCTION CODE 6ETOIOLO 
000066 S8FO 1038 CON34 A 3Re L 15,520,123 LOAD ADOR OF COMMON 170 6£101G20 
COCDGA OSEF A 350 BALR 18,15 LINK TO COMMON GETOIOSO 
cooosc &7FO Co12 90012 36 B LooP LOOP SACK. 
37 *& 
38 ENDPROC CLOSE COFILE,PRFILE END-OF-PROSRAM HOUSEKEEPING. 
coo0070 A 39*eENDPROC DC ovenD or£00100 
0o%070 5810 c1Fa OU1IFO A ace L 1,-=ACCDFILES LOAD R1IS,_ FILENAME ADDRESS oreoa720 
o0007% 0A27 A Ale SVC 39 ISSUE SVC OPE OSTIG 
000076 $810 CIFS OO1FB8 A 420 L 1,=AUPRFILE? LOAD R1S, FILENAME ADORESS OPE CST2Z0 
OO0O7A OAZT A &3e SVC 39 ISSUE SVC ercoerse 
ae fOu 
cono7c A Se os cH EosemasD 
OO007C OALA A be svc 26 covoteTa 
a7 * 


*8 CDFILE OTFCD BLKSIZE=80,£ OF ADDR=ENOPROC »£ RROR-ENDPROC , TOARE Al =COSUFF ok 
RECSIZE=-89 ,SAVARE A-SAVE 
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UNIVAC SYSTEM OS/3 LINKAGE EDITOR 
OATE- 79/09/07 TIME- 21.12 


CONTROL STREAM ENCOUNTERED AND PROCESSED AS FOLLONS- 


4% 
LOADM BALOAD 
BALOBJCT*RUN LIBE MODULES 
OPSCORO SAUTO-INCLUDED? 
ORSCOMN] *AUTO-INCLUDEO? 


*DEFINITIONS DICT 


TONARY? 


PHASE. ADDRESS. 


SVPBOL. TYPE. PHASE. ADDRESS. SYMBOL. TYPE. 

BalLosuct CSECT ROOT 00001890 cos1o00J CSECT ROOT 
COFILEC ENTRY ROOT 00001582 COFILEE ENTRY ROOT 
opscon) EwteRy Root ooooouca DPSCOM2 ENTRY ROOT 
DF SCONS ENTRY ROOT No000000 OPSCOMS ENTRY ROOT 
OPSCOn7 ENTRY ROOT doo0n000 ORSCOM] ENTRY ROOT 
ORSCOR?IS ENTRY ROOT COOONSES DRSCOM2 ENTRY ROOT 
DR SCOME Entry Root DOCOOSE 8 ORSCOMT ENTRY ROOT 
WESALP ENTRY ABS 00901690 RESRES EWTRY ABs 
PRFILE ENTRY ROOT 90001580 PRFILEC ENTRY ROOT 


OudG0sSES 
590001588 
oosq0000 
90000000 
cooonsEs 
ooocnses 
NOCOCSES 
30901690 
36001582 


** ALLOCATION MAP #3 


LOAD moDULE - BALOAD SIZE - 

PHASE NAME TRANS ADDR FLAG LABEL TYPE ESsIO 

BALOADOO NODE - ROOT 

ee START OF AUTO-INCLUDED ELEMENTS - 

- G3/03/78 37.22 - PRSIOE obs 
PRSIOE CSECT o1 
DPSsCcOMT EnTRY 01 
OPSCOND ENTRY 11 
DPSCOM1 ENTRY a1 
DPSCOM6 FUTRY 01 
DPSCOM2 ENTRY 01 
DPSCOMS ENTRY o1 
DPSCOMS ENTRY o1 
OPSCON3 ENTRY 01 
- 77/09/29 12636 - cosiou ob 

cOsIoDs CSECT 02 
DRSCORI1S ENTRY o1 
DORSCOMI EnTRY 01 
DRSCOMZ EnTRY o1 
DRSCOM3 ENTRY o1 
ORSCOMG EnTRY Oo. 
DRSCORT EnTRY 01 
DRSCONS ENTRY o1 
DRSCOM1Z EwTRY 01 


oooo01esc 


LWNK ORG 
90000000 


90800000 
eoooo000 
donoco00 
ooooccce 
s0000c0L 
ouyoo0000 
0000000 
"9000000 
e9900G00 


CUOCCORES 
CO0OOsES 
o0000SEs 
OO000RES 
CO0ONSES 
CONCOSE Ss 
O0000SEs 
No000sES 
ooo00ses 


SYMBOL. 


CDFILE 
DPSCOMd 
DPSCOMm3 
DPSCOMS 
ORSCOM12 
ORSCOMS 
ORSCOMS 
PRS IDOE 
PRFILEE 


HTADDR 
conolear 


ooroose 3 


ooro1ser 
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TYPE. PHASE. 
ENTRY ROOT 
ENTRY ROOT 
ENTRY ROOT 
ENTRY ROOT 
FWTRY ROOT 
ENTRY ROOT 
ENTRY ROOT 
CSECT ROOT 
ENTRY ROOT 
LENGTH 
90901690 
noooosts 
“ONONF AS 





VERTSOSO3 


ADDRESS. 


60001510 
ooraor0no 
sonono0G 
oorooano 
MONONSES 
ooronasee 
NONONSES 
oooananc 
70001SB8 


Of) ORE 


0000000 
ocono000e 
Jo0000n0 
oocosono 
fononooo 
ocotononu 
qonosonc 
oovo0a0e 
oonoooroe 


oo0e0000 
oooa0000 
oo000a00 
oo0ce000 
oooono0a 
oonon000 
ooooocea 
ooconoco 
oooo00te 
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PHASE NAME TRANS ADOR FLAG LABEL TYPE €Ss10 LAK ORG HIADOR LENGTH OB) ORG 
¢@e END OF AUTO-INCLUDED ELEMENTS - 
- 79/09/07 21.11 - 


















0 
aloBs HuU00189L f0N0168F 9onon210 sononono 
DFILE R } Noeoisie conocaso 





COFILEC Entry 1 ctooorss2 fo0000B2 
COFILEE ENTRY cep | 00001588 noovocoss 
PRFILE ENTRY Lap | CO9015#i novocorO 
PRFILEC ENTRY o1 n00015B2 90000122 
PREILEE ENTRY ts | £0901538 no00n128 
onco14a9o 
FLAG CODES - 
8 - BLM DATA CSECT D - AUTO-DELETED E - EXCLUSIVE ‘A* "REF 6 - GENERATED EXTRN I - INCLUSIVE °V* REF 
& - OEFERRED LENGTH MH - AULTIPLY DEFINED N - NOT INCLUDED P - PROMOTED COMMON R - SHARED REC PRODUCED 
S - SHARED ITER YU ~- UNDEFINED REF ¥o- VCON ITEM 


ANY OTHER CODES REPRESENT PROCESS ERRORS? 


LINK EDIT OF *°BALOAD’® COMPLETED 
OATE- T9/Q9/NT TIME- 21.12 
ERRORS ENCOUNTERED- 009G UPSI- xX*CG* 





Figure 4-2. BAL Dump Analysis Listing (Part 7 of 7) 
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COBOL Dump Analysis 


In this subsection, we analyze a JOBDUMP generated from a COBOL program called 
COBOBJ. This program acts much like the BALOBJ program in 4.2: it reads two 
numbers off a punched card, adds them, and outputs the sum to the printer. In our 
situation, the program aborts after reading the third data card in the deck. We have 
inserted an // OPTION JOBDUMP card immediately preceding the EXEC instruction 
for COBOBJ. We have also, as required, routed the JOBDUMP output to a separate 
printer file with an LFD of PRNTR, thus causing the JOBDUMP to appear after the 
entire user log has been output. 


Materials Used 


The materials we will use in this analysis are contained in 4.3.4. They are as shown in 
Figure 4-4: 


¢ The COBOL source code for COBOBJ 


¢ The COBOL object map produced by the COBOL compiler in response to the 
LST=O parameter 


¢ The linkage editor allocation map 


e §6The edited JOBDUMP 


Outline of JOBDUMP 


As before, we will use the step-pointer method to find our way through our dump 
analysis. Before we begin analysis, you should look at the portion of the JOBDUMP 
shown in Figure 4-4. As you can see, these pages interpret the raw dump and present 
pertinent information in the form of charts, tables, and other narrative. 


The remainder of the JOBDUMP shows the contents of the user job region in 
hexadecimal. Like the EOJ dump shown in 4.2, both margins contain the address of 
the first byte in each line. Unlike the EOJ dump, though, the JOBDUMP interprets 
dump data in EBCDIC in a column to the right of the data itself. Also, unlike the EOJ 
dump, the JOBDUMP uses different base addresses according to the following 
scheme, shown in Figure 4-3, 
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As you can see, the simple EOJ dump division of a job into its prologue and its 
program region is extended in the JOBDUMP. Each table in the prologue has a 
header and its own self-relative addresses in its left margin. Likewise, each CS9ECT 
(control section) within the program region begins with a header and has its own set of 
self-relative addresses. (Certain spooling and related tables in the prologue keep their 
negative job-relative addresses in a manner like that of the EOJ dump.) 





LEFT RIGHT 
MARGIN MARGIN 
ADDRESSES ADDRESSES 
fe) 
RESIDENT SUPERVISOR 36 
(OTHER JOBS) 
e 
~~ ~900000° 0 0 ss ~S” et 
ae PREAMBLE 
000000 
000020 TCB 
PROLOGUE 
e 
OTHER 
JOB-RELATED 
TABLES 
JOBDUMP ‘ 
000000 000000 
000020 FIRST 000020 
CSECT 
000000 
000020 SECOND 
CSECT oan 
MODULE 
000000 
000020 THIRD 
CSECT 
e 
e 
SAME ADDRESSES _ 
UNUSED UNUSED 
AS RIGHT MARGIN SUG ePORAGE Seats 





Figure 4-3. JOBDUMP Organization 
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The prologue/program region division of the EOJ dump is carried over to the right 
margin except that the JOBDUMP prologue contains absolute system addresses while 
the JOBDUMP program region has self-relative addresses extending down the entire 
region. Unused main storage within the job region (that main storage not contained 
within the program region) is addressed relative to the job in both margins. 


The JOBDUMP margin addresses will find much use in the upcoming analysis, so 
look at the JOBDUMP, Figure 4-4 (parts 6-14), to familiarize yourself with the 
JOBDUMP addressing scheme. 


JOBDUMP requires space on the first VTOC cylinder of SYSRUN to allocate files. 
Users should eliminate unused files on SYSRUN. 


4.3.3. Analysis 


To determine what caused the JOBDUMP we proceed as follows: 


0- 0-0-4-0-0-0-6-8-8-0-0-0-0-4-4 -8-6-0-4-0-8-8-0-0-0-4-8-8 
1 1 
2 TASER conTRrRont BLOCK 1 * 
1 1 
8- 0-8-8- 0-0-0 -4- 8-8 -0-8-4-$-0-6 -8-8-0-8-8-8-6-8-4-0-8-0-2 


TASM CONTROL BLOCK AT ADDRESS 349116 
TASK KEY = 1 
OWLY TASK AT PRIORITY 8& 
TCB FLAGS 
WAIT FOR TRANSIENT 
WAIT FOR CANCEL IN PROGRESS 
ORIGINAL PSu HAS BEEN SAVED 
PREAMBLE ADORESS = 0196CL 
TRANSIENT ID/S¥C CODE = 1¢ 





@** TASK PSH #88 
PROGRAM STATUS WORD = CO160007 00001A84 
PROGRAM KEY = 1 , WHICH IS JOB CoByoB 


INTERRUPT CODE 
CONDITION CODE = I 


INSTRUCTION ADDRESS = [U01A88 | 
NONZERO INSTRUCTION LENGTH[66 BYTES) | 
OPERATION: INSTRUCTION: 


We first look at the task PSW in the JOBDUMP narrative @ . There, all information 
contained in the PSW is extracted for you. Using this information we see that: 


¢ The interrupt code of 07 indicates a data exception (see Table A-1). 


¢ The failing instruction is add decimal (AP). 
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¢ The instruction address can be found by subtracting the AP instruction length 
from the address given in the PSW: 


1A44 PSW address 
-_ 6 Instruction length 
1A3E Failing instruction address 


As before, all addresses given are relative to the job base address. Since data 


exceptions are associated with operands in main storage, we should find the operands 
addressed by the AP instruction. 


@ 






REG O REG 1 REG 2 REG 3 Ree 8 REG 5S REG 6 REG 7 
FRFFFFF2 oo00017a8 0000177C¢ Looo0scs 8ud00Ssa o20018a8 n10018Fea 0001948 
REG 6 REG REG REG B REG Cc REG O REG E REG F 
OOTEFFFE OOTFFFFF oo001T18 90002728 SOODISFA 00001999 #0001a10 angoiaio 





The two operands of the AP instruction shown in @ are both of register-displacement 
type using register 10 (A,,). @ points to the contents of register 10 at the time the 
exception occurred. From this we can find the two operand addresses: 


1718 Register 10 contents 1718 Register 10 contents 
+ 8 Operand 1 displacement +18 Operand 2 displacement 
1720 Operand 1 address 1730 Operand 2 address 






@es Cospoadg coptobduu PHASE #808 


DODGOO-USFOASED EAOGOTFC DBADFOI2 VESPABAD OMAOTIFE YOCDITIS OODUZTIB UNDDIGEL es cDoecceDecseereccccccvcccccece—OOl6FD 





000200000199" NuovOODD aDVODDUG DH00%00D [DDESONfe VEFIESID FZTAIOOZ VZTAITOS FeerececnccccccecseeceDVeetevetes-OOMTIO 
0000%6-400Z32CP0 £598D201 SODSESOA O2Z013006 OODOOIAGE LOCOIVFE NUOOITAS DOGDLTAS Sr eveVeKoneVeKeceveereveBovccces 27001730 


000060-9000182N 60001820 ODOTOEUD "OD00SO8 TOMONACE GNCOOSES MOTFFFFF UWOGDLTIS #eecccce aevcese ercveke eee veecee™ 001750 


In @) we see the two AP operands at the addresses calculated in @). Note that the AP 
instruction operates on three bytes beginning with each operand. In decimal 
instructions such as AP, the low-order half byte of each operand is treated as the sign 
for that operand. Operand 2, at 1730, has a sign value of C, indicating a positive 
number. Operand 1, however, has an invalid sign value of 4. We can see now that this 
invalid sign caused a data exception when the AP instruction attempted to operate on 
it. 
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At this point, we have found the immediate cause of the error, an erroneous sign. We 
now attempt to find how the error occurred. 


PHASE MANE TRANS ADDR FLAG LABEL TYPE Esio LWK ORE HIADOR LENGTH ORJ ORG 
COSBJERR CSECT 01 "00G06NL ronon727 "o70N128 noranare 
CoaBJEP) Entay Oo. "0000674 sonono7s 
COaBJERZ ENTRY 01 NonUnSs8s nonongss 
CO@BJERS Entry 01 "0909698 sonona9s 
CO@BJERS Entry 01 T7QOUDGAA nononoaa 
~ O8/20/79 35613 - cosiou OB 
cos 100V CSECT 1 "go000728 NONO1LOEF "ononrcs Jononora 
ORSCOMIS ENTRY Ol "0900728 fonoooro 
ORSsCcoMm EmtTrRY 01 10900728 PENONGNG 
ORSCOM2 Entry o1 foo0072s oananore 
ORSCORS EnTRY ep rgount2s Aunororo 
DORSCOME EmtRY 01 "o000728 nunangno 
ORSCOMT Entry 01 eo000728 nanrovanoe 
DRSCOMB Entey o1 09009728 eunonane 
ORSCOM12 Entry Ll 30900728 9anono.o 


#¢@e ENO OF AUTO-INCLUDED ELEMENTY- 
- 79/99/06 00-55 - OBOBYrO ' 


COBOBUCO CSECT ne OG0016Fu 00001090 QoCO3AaE gapuroroe 


on0016F0 


Because the COBOL compiler generated all the instructions leading up to the error, 
we now go to the COBOL listing and linkage editor allocation map for program 
COBOBJ. We will have to look at the allocation map first because the COBOL object 
program we seek is only one among a number of object modules occupying load 
module COBLOD. We see from @ that the AP instruction address of 1A3E lies 
between the LNKORG address of 16F0 and the HIADDR address of 1A9D, thus 
placing it inside the COBOBJ00 CSECT. (This CSECT is also labeled in the 
JOBDUMP; see @) .) We will need to know the displacement of the AP instruction 
within COBOBJ00 and this can be done as follows: 





1A3E Instruction address from @) 
-16F0 LNKORG address 
34E AP instruction displacement within COBOBJ00 


Ramee 6 BASEOISPL andere ss CONTENTS OF MEMORY OPERAND ADDRESSES OPCOOE COMMENTS 
00050 c 030 OOOS3A F2 22 a 018 5 LOO Ou"gso PACK aobd 
c 9% FC A OLA "90 


0903488 F2 22 a 008 S LOS 
UD 





c oso GOG3SA 96 FO 6 CO3 or 
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Looking at address 34E 6) on the COBOL object map, we can see the COBOL 
instruction that generated the AP. Under the heading OPERAND ADDRESSES are 
listed the addresses of the two AP operands. We can confirm this by finding their 
addresses relative to COBOBJ: 


16F0 LNKORG address 16F0 LLNKORG address 
+30 Operand 1 address from © +40 Operand 2 address from® 
1720 Operand 1 load module address 1730 Operand 2 load module address 


Compare the two addresses to the addresses calculated in @. 


Because operand 1 is the operand that contains the erroneous sign, we should look at 
instructions prior to the AP instruction that used operand 1 (see illustration above 
® ). Using the OPERAND ADDRESS column, we find that a PACK instruction © 
used operand 1 as its destination field. We next look at the source operand. 





REG O REG 1 REG 2 REG 3 REG 4 REG 6 REG 7 
FRFFFFF2 00001708 o000177¢ Loo00sce8 8u00055A 02001848 n1no1srs 0001948 
RES 8 REG 9 REG A REG B REG C REGO REG E REG F 
OOTEFFFF DOTFFFFF 00001718 30002718 400019F A on00199" s0001a10 anoo1aio 


The source field, like the destination field, appears in displacement/base form and 
uses register 5. Looking at the register contents @ , we can calculate the source field 
address as follows: 


(02)0018A8 Register 5 contents (leading byte ignored) 
+ 5 Displacement 
18AD_ Address of source field 


For a 4-byte address such as the one in register 5 above, only bits 8-31, the low-order 
three bytes, are actually used in addressing main storage. 


POPIAI-DNO7BHON OLCONUPO ONUdUCCO N0DDDG OGODDGO OMONOnON F2F3FZ4a0 F Poascccncccnccccevccccs +0232 365 -001890 
| COOICO-NOANDZCS D3ID3CSEB GBSOE3DE DASOSUD SOSOSUSO 4HO4NANKD SUSOKUAD SOMNKOND © KELLEY, TOM -0018B0 
| COOLEC-FIFOF 389 SOF3FOFZ ATADESC DSC3C5DS E36BSLCT CSD609C7 C58Q4OSG HORDNNAN 41M3 342 VINCENT, GEORGE -001800 


At location 18AD ©@) , we see that the three bytes operated on by the PACK instruction 
of © comprise two EBCDIC digits and a blank. The PACK instruction had treated 

| the blank (X’40’) as a signed digit by inverting its half bytes (X’40’ becoming X04’) 

| thus causing later difficulties by accidentally putting an invalid hexadecimal digit (4) 


; in the sign. 
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We see by the interpreted data in the right half of the dump printout that these bytes 
formed part of a character string, very likely part of COBOBJ’s data division. To 
check this we look next at the data division memory map output by the COBOL 
compiler. 


DATA DIVISION MEMORY MAP 
LINE LEVEL DATA NAME REG DISP ADOR LENGTH TyPFr 
00025 FO COFILE 


00028 01 COBUFF 5 mono => GP 
00029 02 A001 5 ft30u 3) NUP 





Dgo39 O2 FILLER 5. 003 2. ASN 
00031 O02 A002 5 muds 3 NUP 
pou R PONS N 
00033 O2 NAPEIN S rona 37 AJN 


Looking at the data division main storage map of the COBOBJ compilation listing @) , 
we see that location 18AD lies within the input buffer CDBUFF and has the 
data-name ADD2. (Compare this address with the source field address in the PACK 
instruction calculated in @ .) We see too that ADD2 is a 3-character unsigned 
numeric field that is offset within the buffer by five bytes. Let’s see what ADD2 
contained a the time COBOB failed. 


ADD1 ADD2 






PSPIAI-DAGRUNAN DECOAUCD ODUDUCOO TODODDDG COODDLOD ONO FZF3FZ9O FIFGFSHD Pecccccncccccccccccccesed2 52 [365 | -001890 
CODICE-SONNDZCS D3O3CSEB GBANE SOG DAANSUND SOSOSLAD SDSNANSO SUS0SUSD SONKDNT © KELLEY, TOM CDBUFF -no1880 


COUIEC-FIFOF 389 SOF3FOF2 STRNESCS DSC3CSDS E36BALCT CS06D9CT CSSO8DNG BDADNNeN 813 362 VINCENT, GEORGE -0018D0 


The interpreted data at 18AD fh) shows that input numeral 365 incompletely 
overlaps data area ADD2, the leading digit falling outside of it altogether. By looking 
at the COBOBJ data division main storage map, it becomes apparent that the 
program exception was caused when the numeral to be input as ADD2, 365, was 
punched one column to the left of where it should have been. Repunching the card 
correctly will resolve this particular problem. In addition, you should include error 
handling routines in your program to prevent future recurrences. 
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4.3.4. Dump Analysis Materials 


This subsection contains the edited printout from job COBADD, including the COBOL 
source program, compilation, and link edit for program COBOBJ. In addition, an 
edited JOBDUMP produced from the execution of JOBDUMP is shown here. All the 
pointers referred to in 4.3.3 are shown in numerical order, each pointer referring to 
the part of Figure 4-4 on which it appears. 


@) part 7 6) part 3 
(2) part 8 @) part 8 
(3) part 12 part 13 
(4) part 5 (@) part 4 
(6) part 3 (0 part 13 
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COMPILED BY UNIVAC OS/3E COBOL COMPILER VERSION 06.00/09 OATE 79709706 TIME 906 


44 PARAM IN=COBSRC/INCPUT 


47 PARAM LST=ES,0,N gh oC? 


SOURCE CREATION 


LINE NO. 


oo001 
00002 
00003 
00008 
90005 
90006 
00007 
90008 
00909 
0910 
00011 
oon12 
foe13 
009148 
oons 
00n16 
0017 
90718 
co919 
"0°20 
ro%2) 
0022 
60923 
007248 
"0925 
"07926 
70727 
ron28 
no%29 
00°30 
00931 
00032 
00933 
20938 
00935 
90936 
00037 
00938 
00039 
oo00s0 
00091 
00082 
00083 
oones 
00085 
00086 


DATE 


ane eae 


* 


* 


s 
* 
* 
* 


T9IFOS/1S TIME 20.30 
SOURCE STATEMENT 


IDENTIFICATION DIVISION. 
THIS PROGRAM ACCEPTS TWO 3-OIGIT NUMBERS 
FROM A CARD RECORD, ADOS THEM, AND OUTPUTS 
THE SUM, ALONG WITH CERTAIN IDENTIFYING 
INFORMATION TAKEN FROM THE CARD, 10 
THE PRINTER. 

PROGRAM-ID. COBOBJ. 

AUTHOR. SYSTEM PUBLICATIONS. 


ENVIRONMENT OLVISION. 
CONFIGURATION SECTION. 
SOURCE-COMPUTER. UNIVAC-9L30- 
OBJECT-COMPUTER. UNIVAC-9L30. 
INPUT-OUTPUT SECTION. 
FILE-CONTROL. 
SELECT COFILE ASSIGN TO CARO-READER. 
SELECT PRFILE ASSIGN TO PRINTER. 


DATA OIVISION. 
FILE SECTION. 
COFILE IS THE INPUT FILES CARD INPUT MUST 
BE IN THE FOLLOWING FORMAT: FIRST t-DIGIT NUMERAL, 2 DLANKS, 
SECOND 3-DIGIT NUMERAL, 2 BLANKS, CHARACTER 
STRING UP TO 39 CHARACTERS LONG. 
FO COFILE 
RECORD 40 CHARACTERS 
LABEL RECORDS ARE OMITTED. 
01 COBUFF. 
O2 aDOl PIC 9I3d- 
O2 FILLER PIC Xx. 
N2 aOD2 PIC 9(3}3~ 
O2 FILLER PIC XX. 
O2 NAMEIN PIC XE30). 
FO PRFILE 
RECORD 4&5 CHARACTERS 
LABEL RECORDS ARE OMITTED. 
01 PRBUFF. 
O2 suM PIC S9(8d- 
O2 FILLER PIC xXC3d. 
O02 NAME OUT PIC XE303. 
O2 FILLER PIC xXt33d~ 
PROCEDURE DIVISION. 
BEGINPROG. 
OPENm INPUT COFILE. 
OPEN OUTPUT PRFILE. 
Loop. 


Figure 4-4. COBOL Dump Analysis Listings (Part 1 of 14) 


$9.88 


IOEN. 


CoBsrROOoN 
COBSRN1N 
COBSRN20 
COBSRAZN 
COBSR AN 
cossRnS” 
COBSRIGN 
COBSRN74 
CoRSR18n 
COBSRI9" 
cossrian 
copsRriin 
cossri2e 
COBSR1I3" 
COBSRI49 
COBSR15" 
COBSRI6" 
COESR1I7% 
CopSR18" 
CoPsrRi9n 
COBSR20N 
coresr2in 
cospsr220 
COBSR23"% 
cnesrean 
COBSR25% 
CObSR26" 
CORSR27% 
COBSR28N 
CORSR29" 
CObSR3u" 
copsr3xin 
copsa3z2q 
COBSR3 3 
COBSR3aNn 
COBSR35" 
COBSR36N 
COBSR37N 
cogsrszan 
CORBSRI9N 
cossrsoo0 
cossrain 
cossre2n 
COBSRSSN 
Coesrsan 
COBSRaS” 
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00001 











sasAjeuy dung 


T “Ady O866-dN 


Lev 


LINE NO. 


oona7 
50088 
90989 
990950 
90051 
0982 
90953 
0758 
00955 
20756 
o0oos7 
00988 
n00s9 
nader 


SEQ. 





* 





SOURCE STATEMENT IDEN. 

READ COFILE AT END GO TO ENDPROC. COESR4S6N 
MOVE SPACES TO PRBUFF. cogsRra7n 
ADD THE NUMBERS, PUT RESULT IN OUTPUT BUFFER. CcoesRreen 
AOD ADDI, ADD2 GIVING SUM. CoBsR|agn 
MOVE CHARACTER STRING TO OUTPUT BUFFER. coesrsoan 
MOVE WAMEIN TO NAMEOUT. copsrsir 
WRITE OUTPUT RECORD. coBsRs2¢° 
WRITE PRBUFF. COBSR5 3" 
LOOP BACK, COBSR54&" 
GO TO LOOP. COBSRSS" 
HOUSEKEEPING AT END OF PROGRAM. COBSRS56% 
ENDPROC. cossrs7fr 
CLOSE COFILE, PRFILE. coesrsan 
STOP RUN. COBSRS59N 


Figure 4-4. COBOL Dump Analysis Listings (Part 2 of 14) 
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oud02 
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Bev 
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LINE 8 


07043 


00088 


o7085s 


02004%6 


o008%7 


ocos? 


0704%8 






BASEJOISPL 
c 443 
c sos 
c ous 
c coac 
ce 0:13 
c 019 
c O16 
Cc OA 
Cc OLE 
c 022 
c 028 
Cc O2A 
c 039 
C 936 





ADORESS 


G00258 


O0UZ9A 
d0G2a0 
00U2E8 
oOG2EC 


LN OZFO 


ono2ro 
GOL2F& 
UD02F 8 


UCG2FA 
SOGZFE 
090302 
GOuUsus 


090368 


o9u308 
QOL3OA 
OCU3UE 
000312 
udus16 
UOUSLA 
GOGSIE 
006329 
000324 


O°L328 
00G32C 


Q0032E 
vOu3s4a 


QCOI3A 
uoosan 
000388 


tha 
OOO35A 


GOO3S5E 





CONTENTS OF MEMORY OPERAND ADDRESSES 


&EF OF OF OF OF OF OF OF OF CF OF OF OF OF OFO 
F OF OF OF OF OF OF OF NF OF OF NF OF DF NFOFO 
FOSE 8080808080 40808 0408080404I4n 
SNSO0SCSOROeO4N aNsOeOaNaladanartan 
8040 

0700 O70 GTO 


soooolac 72 


vnocooon 
BEGINPROG 

58 1U A L38 AUNISC 
s@ FL A i86 "orure 
US €F 

$8 lu A O3C "O0U648 
58 FO A u88 PoMure 
OS EF 

90 66 A Ube "0908C 
Loop 

us Ci 

$8 10 A L34 fF IPOsSc 
#21 FO C CIE 790328 
Ss? FU 1 L268 

92 1b 3 L32 

58 FU 1 U3 

us €F 

90 SS A u6L W098 
47 FO C u24 "ON32E 
58 Fu A 28 Cu0uSu 
us EF 


D2 03 6 ONG 7 L3E 
02 23 6 u94 6 100 


F2 22 a 018 5 LOU Curuso 
ge FC A OIA 00082 
As 7 a 008 5S LOS 


96 FO 3 co3 


02 10 6 UO? S LDA 


u0uU796 


OPCODE 


oc x 


CwoPp 


Oc A 


FALR 


LA 
st 
MYT 


RALR 


STM 
BC 


RALR 
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COMMENTS PAGE 00005 


32 +¢ad00ManONODODGN0N 


foanonononoouco0a 
Ne 


PARAGRAPH HEADER 


OPEN 


OPEN 


PARAGRAPH HEADER 


READ 


60 To 


MOVE 


aoo 


MOVE 
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T “A2Y O866-dN 


6c 





PROGRAM-1D. COBOBJ 


LINE LE VEt 








COMPILEO BY UNIVAC OS/3E COBOL COMPILER VERSION COH.LDING DATE 79/N9U6 TIPE 00.5%.98 


DATA OIVISION MEMORY MAP 


DATA NAME REG OISP ADOR LENGTH TYPE PILOC OCC 


* © @ FILE SECTION ¢ © & 


seee8 


oo0025 Fo 
00028 91 
oa029 


TALLY 


COFILE 
COBUFF 
G2 Add) 





oo033 


ooo3s8 Fo 
GONns? 02 
00038 
90039 
ogned 


G2 NAMEIN 


PRFILE 
PRBUFF 
o2 Sun 
U2 FILLER 
Q2 NAME OUT 


* N00 IMUNLIC 3 oP 
5 bart bal 9) a7 GP 
5 CI0u 3 NUP 
0903" O2 FILLER 5S 403 2. AIN 
DOO t ILLer a 8 
5 rona 37 AJN 
6 059% a7 GP 
6 9ou & NUP 
& fun 3) ASN 
6 9097 37 AsN 
6 025 3 ASN 


cone 


O2 FILLER 
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PAGE 061907 


LINE NUMBERS OF REFERENCES 


UC8S GTO87T UNGS9 
oncso 

UNS o 

ONL52 

ofuss L059 

unuee ofrosea 
G50 


uMOs2 





sasfjeuy dung 








> iw] 
Ww c 
Oo 
PHASE NAME TRANS ADDR FLAG LABEL TYPE Esio LNK ORG HIADDR LENGTH ORV ORG 3 
COaBJERR CSECT OL "09006NL "onanT2?7 "o%0N128 Forgnang G 
CoaBJEP) ENTRY on “0009674 nonona7e 2 
COABJERZ ENTRY 01 NONUNS8S& nononose 
CoaBJer 3 ENTRY 1 70907698 nonora9s » 
COdBJERY ENTRY 01 AQDNGOGAA NONONDAA < 
- GAs20/79 35013 - cosi0u oBy % 
CbsI0DN = CSECT OL nonoe7ze "UN01 OFF “ononrcs nunonaro o 
DRSCOMIS ENTRY 01 70900728 nanonoro 
ORSCOMI ENTRY 01 70100728 nunonans 
DRSCOR2 ENTRY m1 run0n728 nananoro 
DRSCONM3 ENTRY 01 raoun72s alVial¢harv ial #) 
DEECOM6 Entry 1 "o900728 NuraourGe 
ORSCOM?T ENTRY lob y “g0u0728 anor ongE 
DRSCOMS ENTRY o1 oyN09728 ergnotoro 
DRSCOMI2 ENTRY 1 *3700728 oanano0 


eee END OF AUTO~INCLUDED ELEMENTS - 
- 7949/06 3UeS5 - 










cosoBuru CSECT "GN016Fu *OFU1A9D POMONSaE AGRGAMUPE 


O"O016F9 


FLAG CODES - 
B - BLE OATA CSECT D - AUTO-DELETED € ~ EXCLUSIVE °A® REF G - GENERATFD EXTON I - INCLUSIVE °¥® REF 
L - DEFERRED LENGTH M - MULTIPLY DEFINED N - NOT INCLUDED P - PROPFOTEP COMMON R - SHARED REC PRODUCED 
S - SHAREO ITEM U - UNDEFINED REF vo - ¥CON ITEM 
SAWY OTHER CODES REPRESENT PROCESS ERRORS® 


LINK EDIT OF *COBLOD’ COMPLETED 
DATE- 79/09/06 TIME- 09.56 
ERRORS ENCOUNTERED- 9u0G UPSI- x°%O* 





Figure 4-4, COBOL Dump Analysis Listings (Part 5 of 14) 


Cc 
‘v 
ie) 
Ne) 
00 
3 
Es) 
a 

= 

— 








T “A8Y 0866-dN 


Tey 


UNIWAC OS/3 JOBDURP 
DATE: 79/09/06 TIME: 00:56:35 





@ @ © USER ERROR CODE 0020, PROGRAM CHECK 


OS/3 VERSION 6.9 « 
SUPERVISOR CHARACTERISTIC MASK - 73B2 
HARDMARE CONFIGURATION MASK - £109 


cccccce 
ccccccccc 
ccce cccc 
ccc 
ccc 
ccc 
cece 
cece 
cecc ccecc 
ceccccccc 
ccccccc 


0000000 
000000000 
0000 c000 
000 ooo 
000 000 
000 ooo 
000 000 
000 000 
0000 oo0o 
ooo00c0000 
0000000 


$- 0~8- 9-0-4 -4-4~8-4-4-0-8 


1 
* KE 
1 


Y 1 


1 
* 
1 


$- 8-8-9 -8-0-4-4-0-4-4-4-2 


JOB NAME IS 


coe Jo8 


ALLOCATION MAP 


FROM 
18000 
28216 
18108 
19228 
149358 
19568 
18a08 
1808C 


15000 
16AA0 


TO 
re@loF 
14107 
14223 
18353 
18308 
19Aa07 
19AE8 
1SE9OF 


1OAgr 
LFFFF 


+ JOB NUMB 


LENGTH 


6816 
38289 


LAST PHASE LOADED - CosLopoo, 


REGION DAVE - 79/09/06 79/289 


oe J 08 


cCOMWTROL 


JOB STEP OPTIONS 


BBBBBBBBBB 

BBBBBBBBBSB 

BBB BBB 

86B BBB 

BBBBBBBBBB 

BBBBBBSBB 

BBB BBB 

BBB BBB 

BBB BBB JJJJ J 
8BBBBBBBBBB JIIIJIS 
BBBBBBBBBB JJJIIS 


ER - §, STEP NUMBER - 


CONTENTS 

PREAMBLE 

TCcB 

JOB ACCOUNTING TABLE 
OTF ACTIVE LIST 
PHASE LOAD TABLE 
SPOOLING BUFFERS 
LOG SPOOL CONTROL TA 


PRINT SPOOL CONTROL TAGLE 


LOAD MODULE AREA 
UNUSED MEMORY 


PHASE DATE - 79/09/06 


AREA *© @# 


JJJ 
JJJ 
wJJ 
JJJ 
JJJ 
JJJ 
JJJ 
JJJ 
JJJ 
JJ 
J 


3 


BLE 


0000000 
000000000 
0000 0000 
000 000 
000 ooo 
000 000 
000 000 
000 000 
0000 0000 
oeco0000000 
0000000 


BBBBBBBBBB 
BSBBBSBBBBB 
BeB BBB 
BBB BBB 
BBBBBBBBBB 
BBBBBBBBB 
88B SBR 
388 BBB 
BBB BBB 
BSBBBBBSRBBB 
3BBBBBBABAR 


Figure 4-4. COBOL Dump Analysis Listings (Part 6 of 14) 





ver7ai227 





sasAjeuy duwing 


cev 


T ‘A8Y O866-dN 





OPTION-DURP 
OPT ION-JOBDUNP 


JOB CONTROL FLAGS 
JOB ABNORMALLY TERMINATED 
J08 TERMINATION BUSY 
ROLL CUT OF JOB INHIBITED 
PRIND SPOOL FILE GENERATED 
Uva BUFFERS INITIALIZED 
ACTIVE PHASE TABLE PRESENT 


JOB CONTROL INFORMATION 
JOB SCHEDULING PRIORITY - CLO 
JOB CONTROL DIRECTORY DISC ADORESS ~ 307/ if 2 
MO. C¥LS FOR ROLLOUTs/JOBNUNP - 5 
JOBDUNP COPY RUNLIB OISC ADORESS - 374 2/7 1 


e@e2e?r LOADER SEARCH TABtLE * # @ 


SEARCH LIBRARY LIBRARY pus FORMAT 2 LABEL 
ORDER NARE VSN ADDRESS CCsHsRe 

1 S¥SLOD REL ubu oc 28 isas 5714 

2 SYSRUN RELC6L ac28 1584 1732 


O- 0---9-#-4-6-6-¢-8_8-4~-0-0-4-8-0-0-6-8-6-0-0-4-0-8-8-2% 


1 1 
* TAS AK CONTROL BLaock 1 > 
1 1 


8- 8-6-8 - 8-8-8 -4-~ 4-8-8 -—¢-8-~8 -8-¢ -8-4- 8-8-8 -8-4-~$-F-4- 8-8-8 


TASK CONTROL BLOCK AT ADDRESS "141iTL 
TASK KEY = 1 
ONLY TASK AT PRIORITY 8 
TCB FLAGS 
WAIT FOR TRANSIENT 
WAIT FOR CANCEL IN PROGRESS 
ORIGINAL PSW HAS BEEN SAVED 
PREAMBLE ADDRESS = (18CCL 
TRANSIENT ID/S¥C CODE = 1C€ 


eee TASK PSw *# 


PROGRAM STATUS WORD = CO0160007 DODOTAS4S 
PROGRAM KEY = 1 WHICH IS JOB COBJ0B 
07) 


INTERRUPT CODE 
CONDITION CODE = 

INSTRUCTION ADDRESS = [uorass] 
NONZERO INSTRUCTION LENGTH (6 BYTES) 


OPERATION: INSTRUCTION: [FA22 ACLO8 A018 


Figure 4-4. COBOL Dump Analysis Listings (Part 7 of 14) 








BEGIN SEARCH 


dsLOCK 


JCI) 


s00u01 


BYTE 


are) 


27 











saskjeuy dung 


T “A8Y O866-d/N 


cev 





* 


e 


REG O REG 3 REG 2 
FFFFFFF2 000017a8 0000177C 


REG 8 REG 9 REG A 
00001718 


OOTFFEFF OOTFFFFF 
InNFORAMA\T I 






TERMINATION 


TERMINATION SVC UASS 
ERROR STATUS CODE 0020 
ERROR/PSU ADDRESS = 000700 


@- 8-8-%~-8-6-6-#-8-8- 6-8-¢~-8-¢-¢ 


1 
* 


1 


1 
CcOFUZILE * 
i 


B- 6-8-4-8-8-6-8-6-8-¢-8-8-8-8-¢ 


CARD OTFCD AT ADDRESS uO17A8 


REG 3 


Looooscs 


REG B 


40002718 


ON # 


2 


* 


. BUDOISS5A 





REG 6 
n10018Fa 
REG E 
acoolaio 


REG & REG 5 
G20016A8 
s i 


000199" 


REG C 
§UI019F a 





cCB: 00 oD 80 68 OOCUTUNO USGD OO%G UCOMITES SDOUIICE ITL9UNDIYOU™ VC IM 


MODULE FLAGS = 8006 
PUB AT B88 11193 FOR READER 1 
END-OF-FILE ROUTINE ADDRESS = OO1AL8 
RECORD LENGTH ADJUSTMENT = o 
FUNCTION CODE = 17 
ERROR FLAGS = 19990 
COMMON IOCS MODULE ADDRESS = [CON7T28 
ERROR MESSAGE CODE = 06 
USER ERROR ROUTINE ADORESS = 00698 
ctwls 
OP-CODFE = 22 
DATA ADORESS = 001801 
FLAGS = 9090 
BYTE COUNT = 49 
IN THE SAVE-AREA: 
RECORD SIZE REGISTER OISPLACEMENT = Ov 
IOREG OISPLACEMENT = 28 
FLAG BYTE 1 = 49 
FLAG BYTE 2 = 00 
FLAG BYTE 3 = 82 
FLAG BYTE & = 08 
FLAG BYTE 5S = 08 
IraepuerT FIELe 
RECORD FORMAT = FIX UNBLOCKED 
BLOCK SIZE = 80 
ALTERNATE DATA ADDRESS = 001848 
RECORD LENGTH = 39 
EOF-MASK-TABLE OISPLACERENT = 0% 


FLAGS - 


STD RODE ° 
IORG SPECIFIED 
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REG 7 
00001948 
REG F 
enooraio 








sosfjeuy dung 





vEV 


Cc 
vu 
wo 
ee) 
o 
o 
>] 
@ 

= 

tt 








B~ 8-8-8 -0-6 -6 -8-8-4-6-6-4-4-8-# 


1 1 
e PRFILE * 
1 1 


B- 8-8-9-8-8-8-8-8-4-0-8-8-8-8-¢ 
PRINTER DOTFPR AT ADDRESS 0061820 


CCBs OO OO 80 68 DONOCOON ON00 NOOO COG01sSC NOOO1s%s YvoonUMDOVOOO O04 LO 
MODULE IDENTIFICATION FLAGS = 8CON 
PUB AT 0088 (FFF) FOR PRINTER 3 
RECORD LENGTH ADJUSTMENT = 0 
FUNCTION CODE = 20 
ERROR FLAGS = 0000 
COMMON IOCS MODULE ADDRESS = 00000090 
ERROR MESSAGE CODE = 00 
CCul: 
OP-CODE = O01 
DATA ADDRESS = 001920 
FLAGS = OD0U0 
BYTE COUNT = 40 
IN THE SAVE-AREA: 
RECORD-SIZE REGISTER DISPLACEMENT = CO 
IOREG DISPLACEMENT = 2C 


FLAG BYTE 3 = 88 
FLAG BYTE 2 = 80 
FLAG BYTE 3 = 30 
FLAG BYTE & = 88 
FLAG BYTE S = 


RECORD FORMAT = FIX UNBLOCKED 

BLOCMSIZE = 49 

OP-CODE STORAGE = 39 

STD OP-CODE = O01 

ALTERWATE DATA ADDRESS = 3018F8 
FLAGS - 

COMTROL-VES 

IOREG SPECIFIED 

PRIMTOV=SKIP 
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Garetes 
Guticy guesses <oedssncaesevecsevesesa peste dggnonen 
Eoveigawand odcubesdiccentesanesdeceeeees angauren 
Erba vors Renta nsedavinpbacsetatces ase 4 Waoagian 
Cat Ornaskeew an voces bheceee eusewpeuey-eereuner 
ete e sei hus sued etacwed sews bauetaw se Seetanen 


CLT O-eeeeseeee seececsevesecceosscceny JOCIINLG 











Coltnta- ees 
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Figure 4-4. COBOL Dump Analysis Listings (Part 14 of 14) 
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4.4. RPGII Dump Analysis 


In this subsection, we analyze a JOBDUMP taken from an RPG II program named 
RPGOBJ. This program reads two numbers from a card like the programs analyzed 
in 4.2 and 4.3. Unlike them, it divides one number by the other and prints the results 
along with a character string taken directly from the input card. 


4.4.1. Materials Used 
The materials used in this analysis are contained in 4.4.5. They are as follows: 
¢ = Job log for job RPGCHG (the job which ran RPGOBJ) 
¢  RPGII compilation for RPGOBJ 


¢ Edited JOBDUMP 


4.4.2. Program-File Interface - the Input/Output Request Block 


In this analysis, we will look at a software structure used by RPG II as an interface 
between an RPG II program and a file. That interface is called the input/output 
request block (IORB). The IORB is 56 bytes long and contains information that is 
useful in debugging an RPG II program. For our present purposes the format of the 
IORB is as follows: 





+0 +2 


+4 +6 
FILE NAME 


An IORB exists within your RPG II program for each file used by the program. More 
information on the IORB can be found in the System Messages Reference Manual 
(UP-8076). 





+000000 






+000030 
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4.4.3. Program Check Island Code 


Another OS/3 facility that we will discuss in this analysis is the program check island 
code. This code is a software feature that permits users to handle program exceptions 
with their own routines rather than simply allowing their programs to fail. Several 
language processors, RPG II included, automatically include island code in load 
modules, mainly to print error messages and perform other recovery functions when a 
program fails. As we will see later, the program check island code is designed to save 
the hardware environment of a failing program in such a way as to let us see what 
caused the failure. More information on island codes can be found in the Supervisor 
Technical Overview (UP-8831). 


4.4.4. Analysis 


To determine what caused RPGOB4 to fail, we proceed as follows: 







STEP RPGLODDD 8003 21:05:39 


o FO RARE - STAND1 =» COPIES - 0003, PAGES - G0000000, STEP -0n3 


Here we have loaded and executed our load module RPGLOD00, containing RPGOBJ. 
The program, however, fails when the RPG030 message {) is printed in the job log. 
By including an // OPTION JOBDUMP statement in the JCL runstream immediately 
before the // EXEC RPGLOD00 statement, we can cause OS/3 to generate a 
JOBDUMP. In doing so we look at the JOBDUMP narrative. 


0-0-8-0~0-0-8-0-0-9-8-8-8-8-8-% -8-8-0-F-8-0-9-0-4-8-#-9-4 
1 1 
® TASR COMTROL BLOCRE 1 bd 
1 
s 


1 
~ SO - 8-8-8 -9-8-S- 8-8-4 -9-0-8-% -9-0-8-4-8-8-¢-4-4- -6-8-8 
eee PROGRAM CHECK ISLAND CODE #98 
Busy 
@ ENTRY POINT ADDRESS = DO00ATO 


PSUSREGISTER SAVE AREA ADDRESS = ocO0BFN 


PROGRAM STATUS WORD = COI6COOB Foo0o0eSC 
PROGRAM KEY = 1 WHICH IS JOB RPECHG 
INTERUPT CODE = [05] 

CONDITION CODE = 
INSTRUCTION ADDRESS = 00068C 


WONZERO INSTRUCTION LENGTIN [te BYTES?! | 
operation: [oF | INSTRUCTIONS [FOF2 SCI? ScuF] 


At @) we see that a program exception occurred, which activated our program check 
island code. The major purpose of the island code is to generate the RPGO30 message 
indicated by @ . But the island code also saves the PSW under which the error 
occurred. We can thus use this PSW to determine that: 
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Goez00e0ND00000 DODLOODN OfODNDLD 00890 





¢ = The failing instruction was a divide decimal (DP) 


¢ The interrupt code of 0B indicates an oversize quotient, most commonly 
generated when dividing by zero 


Since operand 2 of the DP instruction represents the denominator, we can confirm 
that it contains zero, first going to @). 





REG O RE6 } REG 2 REG 3 REG & REG S REG 6 REG 7 
oooo00008 Eoo006ssé o00GoaFO vooootce uo010590 ocoo2eor n0%0%00u s7onooGn 
REG REG 9 REG A RtG EB REG C REG O F | REG F 
60000672 ooaooaro oo000aFao ooocoepa eonon7ec cootoare 6000084 a1ONOA72 


Operand 2 of the DP instruction is in base/displacement form using register 3 @). 
From register 3, the effective address of operand 2 can then be determined: 


0000 ~—sCiRRegister 3 contents 
+20F Displacement 
020F $Operand 2 address 


Having found its address we now see what operand 2 contains. 






102 DIDS8ODT OIDEDICS DIESCICS FeccccccccccccecescdKLM PROPERTIE -90N02N0 


0002 20-£ 2404090 80989080 80404040 80808080 CODCOCOC 80408080 8O80808O 80808080 es eevee -000220 


442 


In the JOBDUMP, @ points to address 20F. The DP instruction specifies that 
operand 2 is three bytes long, so we highlight addresses 20F-211 to show that operand 
2 does indeed contain a packed decimal value of zero. 


The next question is how the zero value got into operand 2. To help answer that 
question, we turn to the RPG II compilation listing that generated RPGOBJ. 





FIELD MARES 

ABORESS FIELD ADDRESS FIELO ADDRESS FIELO ADDRESS FIELD ADDRESS FIFLD 
0e0180 §«6stRROR OOC1AS PSSONP EXTRN COOZ0C AnD) CON2Z0F ADo2 fuN21z2 NAMEIN 
GoCz230 QUOTE 000235 NAREOT 





The field name list in our RPG II listing shows that our operand 2 address of 20F 
corresponds to a field within our program named ADD2 6). We turn to the RPG II 
source listing itself to see what ADD2 is. 
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ooo #0 1 RPGOBS 

001 001 FCOFILE IPEAF 8S 4&5 READER RPGESROIN 

Bo PO2 FPRFILE 0 vo 98) 88 PRINTER RPGSRAZN 
WOTE 117 

pos J i s0ad0} RPGESRON 





8 120002 RPGSROSN 


Line 005 of the source program © shows that ADD2 is a 5-byte decimal number 
contained in bytes 8-12 of the input record for card file CDFILE (defined in line 003). 
Knowing this, we can then look for the input card that presented a zero value in the 
ADD? field, thus causing the program to fail. 


To pick out the error card we first find the data read into the job from that card. The 
RPG II compiler listing and the System Messages Reference Manual (UP-8076) can 
both help us here. Our intention is to find the IORB associated with file CDFILE. To 
do so we first look at the RPG II compiler listing under the heading "PROGRAM 
POINTERS": 


PFCCRKAM FCINTERS 


TABLE INPUT/OUTPLT cud2s4 
INPUT FIELC EXTRACTICAN cot2se 
DETERMINE RECOFD TYPE COO3CL 
GET INPLT RECORD cccesce 
DETAIL CALCULATICNS ccce7e 
TCTAL CALCULATIONS COCbAZ 
CVERFLCk OUTPUT COC6FE 
OVERFLOW BYPASS cccera 
HEACER/CETAIL CUTPUT Cce7cs 
OUTPUT FIELDS ccc7ec 








As we can see the input/output request blocks @ are located starting at address 8C8. 
We go next to that address and follow the IORB format shown in 4.4.2. RPG II always 
arranges IORBs in the same sequence as the file description statements for their 
respective files. Because file CDFILE is the first file defined in the program, its IORB 
occupies the first 56-byte IORB slot, at address 8C8: 


IORB CURRENT RECORD ADDRESS IORB FILENAME 










CCOCEBL-OCCOC4CN C7CICOCNG3ICSHN4C BONGISIS OGGVIFBC YACIOHFC FE2CCCOO L2FFFFOC FeeeePRFILE sencevveveeDWeveneee-Cileal 


COCBAG-COCOCF96 C1CCOE32 VOQCICIC DS2CH4OC S4SA2G04 LMICOYCIS CUCCOS7Z COUCTCOCO Pavecneveveccccvesesecsvcehscasee CCC EAL 












eevee oe OCCECL 


GOVTSBPCOCESSOL CO2OACC1 COCLUCKHF FFFFFFOCC COECLO1I [Fee veascesenecnssssece 


CICHCECS CICENTH [Heeveecevessbesoneveses 


Cececc-atcacace 423¢0000 /37 





CCCB8EL-LCCOCOCO CCCoCuga uCacuTCce FelGMrFaAC CLOUdIoL “vecnocue 
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COC7TEC-CCCGL 764 Seszcaze 


CCCPeC-CZIGECL] F234QaMT 2234021C 





Bytes 1-3 © of the CDFILE IORB hold address 798, the current recozd address. 


At address 798 we find: 






ecosa7ls 698 é. BZ3DF2IC Feececene Feccevccasneses Pee ee i ccc Tec 





72353234 O7FEIC0C 






*Kecvees ve Keveosccoccons acc “Tec7ec 












Ld 
CCOOTACTHCHIMCFO] 4Ce4Sl 102 CICHHlT? COCECTCS CSE3ICICS E24HNHOHC 4L4S4L4C 4HCuCaCHC]s "  VKLM PROPERTIES COS TAC 
COCPCO4F4C4OHONO SCHOICIY O4O08CES COO.CLOC CCCOCLOG COCOLECHPCACCOIEE CCCCLOCO * —=—_—anaaerncccncesvencscvcceeres— cucice 





4.4.5. 








CDFILE CURRENT RECORD 


The large block indicates the CDFILE record most recently released to the program, 
and @) points to bytes 8-12 within the record, the field defined by RPG II field AD2 
(see © ). We see that ADD2 does contain a value of zero, perhaps a mispunch. We 
can also tell, from the interpreted dump in the right column, just which input card 
(JKLM PROPERTIES) contained the faulty data. 


Dump Analysis Materials 


On the following pages is Figure 4-5, the edited printout from which the dump 
analysis of 4.4.4 is taken. The following list indicates where in Figure 4-5 each of the 
pointers of 4.4.4 can be found. 





part 1 
part 5 
part 6 
part 7 
part 2 
part 2 
part 2 


part 9 


OOPQGAOEO@FeLBHO 


part 8 
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T “Aey O866-d/N 


Svy 


10 FOB RPCTHE M0005 ( Bok oS) oe ,B0THHOR 
4s ove 20 
77 UFR PenTR 
44 bvC 20 
A7 LED PRFILE 
4s OVC 30 
4s LFD COFILE 
a DYC 50 
tf UBL CPYLIB00 
44 VOL OS3CPY 
7 UFO CPYLIB 
A7RPGSRC RPG IN-LOSSCPY,CPYLIB00) 
47 SUIP ENDER, I1 
47 WORKI 
47 EXEC UNKEDT 
4% 
LOADN RPGLOD 


47 OPTION JOBDURP 
47 EXEC RPGLODOD 
JIENDER NOP 


















se 

AaCOl JOB RPGCHG NO. ASSIGNED MEMORY=C(023080 BYTES {PLUS 003584 BYTF PROLOGUE) 
JC0O6 USING Oe v=aan N=OS3CPY 

JCC? USING DEV=FFF JYPE-PRNTR DEV=119 TYPE=READR 

JCC JOB RPGCHG EXEXUTING JOB STEP RPGIIOCO #901 21:29:94 

€C10 LFD - PRATR oe /FORS NAME - STAND] , COPIES - CICI, PAGES - 59090902, STEP =9NM1 

AC11L STEP 8001 (RPGZIOCO? USED 00022788 BYTES ELAPSED WALL CLOCK TIME=CO:0N291.676 TOTAL S¥C 
aciz TEan cope=-goo SWITCH-PRIORITY=CS5 cpu TIME USED =7902U9209e8%5 TRANSIFNT 
aci9 DEVICE EXCP*s 303=09001638 PRT=O0CCN007S 4#480-00005911 

JCOl JOB RPGCHS EMECUTING JOB STEP LNKEDICO #0G2 21:48:52 

aci0 LFO - PRNIR » FORM NAME - STAND] , COPIES - UNC1, PAGES - ONDDDNO2, STEP -=ONn2 

aCil STEP 8002 KEOTOO? USED GO018822 BYTES ELAPSED WALL CLOCK TIME=96:00:82.532 TOTAL SVC 
ac i2 TERM CODg-000 SW ITCH-PRIORITY=05S Cpu TIME USED =96:00:126125 TRANSIENT 
acigs OFVICE ExcP*’s 3N3=00001638 PRI=-O0COON97? 

JCOl JOB RPGCHG EXECUTING JOB STEP RPGLODCO #003 21:05:39 












TOMASI 


CALLS=M97035 32 
CALLS=forancsce 


CALLS=009G3501 
CALLS=PONONGTA 


PPP rr ee PO Ce Se ee Oe ee eT OO RP OPE PPE PP PP PPP rer re rere 





21803237 
21203880 
21:032601 
22:03841 
21203s01 
212:03241 
21303242 
21:03s01 
21203241 
21203282 
21203282 
21203242 
212:03289 
21:03:50 
21:03:51 
21:03:51 
21:03:51 
2120325) 
22:03:52 
21303252 
212:03353 
21203253 
21203259 
213C82l2 
21:08:08 
21:Cast? 
2r:sca:set 
22:08:51 
21208251 








21:05:38 
22:305:38 
21:05:38 
21:05:38 
21:05:81 
21:05:51 


0 - STAND] , COPIES - GOG1, PAGES - 39000000, STEP =073 22205258 
aca STEP 2003 (uosoneon) USED ONO13552 BYTES ELAPSED WALL CLOCK TIME=C0:00:96.620 TOTAL SVC CALLS=f90N02986 21:f 6:28 
aci2 TERM CODE=000 SWITCH-PRIORITY=~5 CPU TIME USED =00200:318.795 TRANSIFNT CALLS="0N09038 21:06:28 
acig DEVICE EXCP*’s 303=00090985 11G=00000003 PR¥=00000821 21:06:28 
aC2i JOB TOTALS USED 00022788 BYTES TOTAL ELAPSED WALL CLOCK TIME=90:02:29.377 TOTAL JOB Sv¥vC CALLS=90019018 21:06:28 
ac22 WALL CLOCK TIME OF ALL STEPS =90:02:10.828 JOB TRANSEFNT CALLS=90000162 21206229 
ac23 TOTAL CPU TIME OF ALL STEPS =CO0:00:36-755 TOTAL JOB EXCP*S ="9095268 21206229 
JOS JOB RPECHG TERMINATED AGNORMALLY. ERR 000 21:66:29 22306331 | 
AC10 LFD - PRNTR , FORM NAME - STAND1 , COPIES - DOC1, PAGES - uND00025, STEP =uN3 21206232 


Figure 4-5. RPG Dump Analysis Listing (Part 1 of 9) 
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C ICCFILE O11 G1 CINCI 






=] 
UNIVAC OS/3 RPGII VERS B0CS5t2 RPGDUMP BU/U6/26 20648 PAGE 1 5 
no) 
ccc # 1 RPGOSS 

061 C10 FCOFILE IFEAF 45 45 READER > 

oc2 C2C FPRFILE oO F 48 4g FRINTEF ». 
we 
7) 
oe 

Cle cec I 15 44 NAPEIA 

cc? c7co Cc ACD1 CIV. atte QLOTE ec 

cca cec Cc MCVE NAPEIN NAMECT 20 

Gc9 CSC CPSFILE OD 1 Cl 

aig ice Cc CLcTE 6 1d 

Q11 lic ¢ NAMECT E 48 


SYMECL TABLES 


RESULTING INCICATCRS 


4ACCRESS FI ACGRESS FI ALTFESS RI ACTRESS Fi ACCRESS FI ACLRESS FI SOCRESS RI 

cccois IF cCuGis tk sCutlé ob c0u0l7 O1 cCCC7A La cecces #C cCleeé #1 
CCCOB87 tz ccccses +3 CCCC8S RY LCuOga KS cccCee Fe CCLCSC 7 CECCED HA 
cccocee +s ccuderF Li 36099 Ue cOGES1 U3 chClsz us CoucS? Ls cCLC94 U6 
cccoss v7 tCGgaosé Lé 


FIELC NAPES 


ACTRESS FIELC AOCRESS FIELO 6) ACCRESS FIELC ACCRESS FIELC ACCRESS FIELE 
CCC1a0) «= 4ERRCR yac2ec AcDL COM2NF ACCE CCOZ12 NAMEIN COC23G = GUCTE 


CcC234 fAMEOT 


acz ACTS 2F1 


NCTE 202 RESULTING INDICATOR IS INVALID CR LNOEFINEC. ENTRY OF LO IS ASSUPEDs 


PFCCRAM PCINTERS 


TABLE INPUT/OUTPLT cua2s4 
INPUT FIELC EXTRACTICN coct2ss8 
DETERMINE RECORD TYPE CCC3CL 
GET INPLT RECORD Ccesce 
DETAIL CALCULATICNS Ccce7c 
TCTAL CALCULATIONS COCbA2 
CVERFLOw OUTPUT COC6PE6 
OVERFLOW BYPASS CGCECA 
HEACER/JCE TAIL CUTPUT ccc704 
OuTPUT FIELOS CCOTEC 


INPUT/CLTPUT REQUEST BLOCKS cccece 








Figure 4-5. RPG Dump Analysis Listing (Part 2 of 9) 














UNIVAC OS/3 VOBCUMP VERSCO6C4 
CATE: 80/06/26 TIME: 20:50:33 


2 # # USER ERROR COCE stole 


OS/2 VERSION 7.c-.Cl 
SUPERVISOR CHARACTERISTIC MASK - 37BFE%AE 
HARCwARE CONFIGURATION MASK ~ E1G4 


c 
v 
te) 
Oo 
00 
o 
r] 
© 

= 

os 


PRORORRK FPPPPOPP 3666605 ccccccc HHH HHH GEGGGGG 
PRRRERRRARR PPPPPPPPPP cGG66GE556 eccececcce HHH HHH CGGGGGGGG 
RRR RRRP FeP DPpeP S666 SEGE cccc ecec HHH HHH GGOG GGG6G 
RRR RRR PPP PPP 266 ccc HHH HHH GEG 

ORR KARR PPP PPFP $65 ccc HHHHHHHHHHH GGG 
ERIRAORRRER PPPPPPPPPP sos ccc HHHHHHHHHHH 666 
RRIRORER FEPPPPOD SOG f£OS65 ccc HHH HHH GGG GEGGG 
RRQ ROE PPP 566 GE5G5h ccc HHH HHH 666 6GGGG 
RRR PKR pep S&CG G&G cece eccc HHH HHH GGGG 66 
oRA ROAR PrP GGGGGGG6GG ecececccce HHH HHH CGCGGGG6GG 
PRE PRE pep SGGEGSS cecceccc HHH HHH SGGGGG6G 


ee ee eee ee ee ee es ee es Ee Se 
1 1 
4 KE Y 1 * 
1 1 
Pe Ot oe oe ee ee oe Ee ee tel 
JO NEME IS RAGCHS » JCB NUMEER - 1, STEP NUMBER - 3 
ALLOCATICN MAP 
FRCP TC LENGTH CGNTENTS 
LGACC 19B1F 288 PREAPBLE 
19B2C 1947 Z9E TCE 
1SC4E 19¢93 76 JCB ACCCLNTING TABLE 
1SCS4 19072 Z24 CPEN FILE TAELE 
19c84 19ECR 136 PHASE LOAD TABLE 
1AQE4 1A5C2 1lu4 SPCCLING BLFFERS 
TASCH 1ASE7 228 LOG SPOCL CCNTRCL TAELE 
1AecE 1A7BB zz8 REACER SFOCL CCATRCL TASLE 
LATEC 1A8SF 228 PRINT SPCOL CONTROL TABLE 
1AACE 1BAAT 4264 LOAC MCCLLE AREA 
1TAAG 1FFFF 17752 UNUSED MEMORY 


LAST PHASE LCADEC - RPGLOCGG, FHASE DATE - 8C/U6/26 


REGICN CATE - eC/Ces26 BlsI7e 


eae uc 8B CcCCNTROL AREA *# * # 


CB STEF OFTIONS 


I 


Figure 4-5. RPG Dump Analysis Listing (Part 3 of 9) 
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1S OPTICK-CUMP 

OPTION-JCBOUMP 

vCB CCNTROL FLAGS 
vOB AEACRMALLY TERMINATED 
JOB TERMINATICN BUSY 
PRINT SPCOL FILE GENERATEC 
wTL BLFFERS INITIALIZED 
ACTIVE PRASE TABLE PRESENT 
ZERC FRASE AREA ON LOACS 


~CB CCNTIRCL INFCRPATION 


JOB SCRECULING PRIORITY - UCW 

JOB CCATROL DIRECTORY DISC ACCRESS - €6/ C4 1 
NO. CYLS FOR RCLLOUTs/JO8CUMP - 6 

JOBCUMF COFY RLUNLI6 GISC ADCRESS - ls css 


see pt CACTCER SEARCH TABLE #4 8 


SEAR CE LIBRARY LIBRARY PLE FORMET 2 LABEL BEGIN SEARCH 
O8CER NAME VSA ADCPESS CC/H/F BLCCK BYTE 
1 *Y¥$LC0 RELLTC icco 1247 O/ 34 ccoca! cc 
2 fYSRUN SPLOEE CFFG ACC/ M721 cecce?: 4) 


Pie er en ee ee et ey ee ee ee ee ee er ee ee ee ee ee 


1 1 
4 TAS K CONTROL BLOC i * 
1 1 


Pe ee ee ee ee ee ee ee ee ee eee ee ee ee ee ee ee ee ee ee ee ee 


TASK CCATROL ELOCK AT ADORESS C15#2C€ 

TASK KEY = 1 
CALY TASK AT PFICRITY 1: 
TCB FLAGS 

WAIT FOR TRANSIENT 

wAIT FOR CAACEL IN PROGRESS 
PREAMBLE ACORESS = C€19ACC 
TRANSIENT ID/SVC COCE = 38 


ae TAS K FSW #8 


PROGRAM STATUS WCRE = CC160038 41000816 
PRCCGRAM KEY = } wHICH IS UCE RPCCLUMP 
INTERRUPT CCL 
CCONCITION CCD 
PRCGRAM MASK 

FIXEC POINT OVERFLOW PREVENTEC 
DECIMAL OVERFLOW PREVENTEC 
EXPOKENT OVERFLOW PREVEATEC 
SIGNIFICANT ALLOWED 


’ 
? 


mm 


8 
c 


: 
; 





T ‘A8Y O866-dN 


Figure 4-5. RPG Dump Analysis Listing (Part 4 of 9) 
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S INSTRUCTION ADDRESS = GOGB1ie 

eS NCNZERO INSTRUCTICN LENGTH (z BYTES) 

2 OPERATION: SVC RPGMZ INSTRUCTICN: 0f38 

4 : 

o REG U FEC 1 REG 2 REG 3 REG 4 REG § REG 6 REG 7 
a CUCOCOCE Ecocoeee CLCCOEIC eCcececa coccicce ceuc2zoce cece ?zcec oraccece 
s REE 8 REG 9 REG A REG B REG C REG D REG E PEG F 
m 6CCO067z acacessc cooone 3c UOOCLELA cooce7éc CCuCuB se e0Lccocc 41OQGAGA 


4 ae PR CER A PB CHKEC K ITSbtarne ccrceée * 8 * 


Busy 
ENTRY POIAT ACORESS = CLOAGE 
PSW/REGISTER SAVE AREA ACORESS = GPbCiC 


PROGRAM STATUS wCRC = COlOfUGE ECSUCeEC 
PFCGRAM KEY = 1 4 WHICH IS uCB RPGCUMP @ 
INTERRUPT COLE =(CB] 
CONCITION CCCE = 2 
INSTRUCTICN ADDRESS = UIL6EC 
NONZERO INSTRUCTICN LENGTH 


OPERATION: INSTRUCTICN: [FCF2 SC17 32uF 


REG u Fee 1 REG 2 FEG 3 REG 4 FEC £ REG € REG 7 
oceccace BCOCG4AS S2OLI7SE eeeecece Cucciccc cecer ecue COCUILEC gceanccec 
REG 8 FEC 9 REG A REG P REG C FEC C REG E REG F 
€cacce72 CCOCGR3C CCOSNB IC cEuocela Cccer7et crecue3r eeCecece JISUTOETS 


a¢*# TERMINATION INF OR™M& TICN 4 * & 


TERMINATICN SVC 99UF 
ERROR STATUS CCDE JCC 
ERRCR/PSW ADDRESS = C18268 


** e# TERM IA ATION FSWw *# 4% % 


PRCGRAP STATUS WCRO = CCleCice ECCCNEEC 
PRCGRAM KEY = 1 , WHICH IS yvCB RPGCLUMP 
INTERRUPT CCCE =. 
CCNCITION CCCF = 2 
INSTRUCTICN ACORESS = UCcb6ecC 
NCRZERO INSTRLCTION LENGTH (€ BYTES) 
OPERATION: OP INSTRUCTICN: FCF2 SCI? 325F 


bal Rael Rela cial Rd Saal Dela lal el eat ile tle a iad 
1 1 
bf CCF ILE + 
1 1 


De er ee ek ee ee ee ee ee 


CARC DYFCD AT ACDRESS GOG7Ce 





Figure 4-5. RPG Dump Analysis Listing (Part 5 of 9) 
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os+y 
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FFFFAQ-OCCOOO0C asFqduns 1l2FFsearo 00084740 


FFFFCG-O7FFCCCC CCCCCOoo ococucce CCFF3ScC 


FFFFEC-OS1CO7FF Caz70al1C YCGOUCCO Acacccac 


FOI84EFO COCESBFC FODMCTFF SEFOFCZE #, eeeleeeveleee GeeleeeDlMeeel(Oe-ClASAC 


SSCOFAZC 4TEOFOGA CASHOAED 2CIIGALS PecvevevcccseseseseloeeDeccerzesee-CiASCl 


GCOOCCOO FFFFF374 COCCCCCOE COOCTECE Hececccecncccccvvncnseesocesesve se OlASEL 


Pe ee ee ee ee ee ee ee eee ee ee ee eet ee ee 


a- 
1 
| FRkCB 
1 
ae 


Lem 


Rt G ] 


Ss TERS 


1 


1 


Pe ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee eee ee ee ee tt 


REG G 
ecacaG 
KEG 6 
6locde 


ce E 


72 G 


FEG 1 
Cacuese 
FEC 9 
CocoB3sc 


REG 2 


CCOCSe3C 


REG A 


ccacoe?c 


REG 3 
foccurco 





FEE B 
LOUDTETA 


Warde ee eh HHA EAH EME OH R- H-R--RK-RKE 


1 
a tcaod 
1 


* 00D 


ULE 


AG®EA 


1 
* 


1 


Peet ee ee ee er ee ee ee ee ee ee eee eee ee ee 


see RPGC B 


J 


CoS: BC 


CCCodO-QEFOSerG FCCOCTFF UCCCUE2C 


ccec20) 6FcC | 6CCOD 
Cccoéa*xcccoccco 
cccosd-otcacoda 


Cctaag-cccceccco 


cccoco-accccooo 
COCOEO-UCCOU6BE 


cccinc-occococsd 


ccci2zo «tc 69001 


T, EPG 


agceewsac 


SF SAME AS LAST WORD 


eccocang 
ecracana 
cccoc254 
cocoooca 
CCCOO6DA 


cocococa 


acoouccen 
oconacer 
ocugucco 
acococcn 
occeuccc 
acoaousca 


gaccoacoc 
90009u3C 
noccacoc 
SONUDSOC 
cococ704 


90000938 


3F SAME AS LAST WORD 


ceoo0ceo 
Cveacceu 
ocoududG 
ocogdcco 
ecooicou 


OC000936 


FEC 4 


eccciccc 


REE C 
OUoCe76e 


fe] PHASE #8 


REC § REG 6 REGS 7 
ceacectcec CCCCILee GONNucce 
REE C REG £& PEG F 
eCCCuB3r eccccoce 4IDOCAGA 


* 


SCcmrcrc OlLCcecce CCOCCCCC 


agocagooc 
ceceococ 
occogooc 
ceceue7c 
cocaococ 


ccccocce 


COOCFEEC 
neecezec 
oucce2se 
COCCLEAZ 
ccecocce 


cecececce 


ocuccece 
Ccosccce 
cCceezce 
Chooccce 
ccooc7ec 


cececcce 


Hel elle cccccccccvscsvcciteccesese-Cil(li 
PevaccccreceseccsccccsveseslLecsee-COClEl 
Perec eleccesesesensccccesessveses-CUCt Bt 
Foccvcccrcccevecsesvesscvecesceve~LUClAl 


A ceisie wdweweW slaebeebeviede eee bese eclCCECe 


Ferccccsravecncccsvcscvevcsesess-~COClCEl 


Pececccccccotsecsasvesccecccssese-CUCIOl 
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cociso*occacoca ocoudoou 
CCClec-cccocooo Cccocoo2 
CcClsu-occogdco 40404040 
CCCiaG-cccoccea cccacooo 
cccica-cccocoge eccooucG 


ocogoccc 
oco2ucco 
scooocca 
acaouccG 
acGgoocco 


coocdaes 
oooqoaca 
O9G000E2C 
dcecocse 
doccsoac 


CCCIEG tC OODLFF SAME AS LAST WORD 


ccoczocscccecoce cccocadd 
CUCeé20-Eez4ceoan 4c4a4a4y 
CCC24G-4F4Gg4n4d 40404040 
COC260-c7ECSSEY CClS412e8 
Coc2e80~-312G9805F8 O7CCO7NU 
CCEZAC-CCCELCLE 1cicicic 
Ccec2co-2c2C2czC 3C3C3C3C 
CUCZEQ-4C4D4C4C SCECECSC 
Coc3z00-ecerecec FC7IC7TC7TC 
CCC320-ecececec SCSCscgc 
CCOZ4G-AC pC ACAC ECBCBECBC 
ccc36q-cccocccc CCECOCOC 
CCC3EQ-ECEDECEC FCFCFCFC 
COC3AQ-FZ24320F 2087009 
CCC3CC-SceEocCCC Secsctagu 
COcscq-ce2sosel Cecucas 
CCC4O0-47FO8028 58503198 
ceoca2c-aCleasca ag720200 
CCCH4C-ECCessel CC1041 3 
CCC460-ACCOS2FO 208592C3 
CCC4SC-47TECADGE CASB4TFU 
cCC4aC-1C1607FC 45110020 
cccacco-occococr 4§4£&0020 


ocgcucce 
sc4oucag 
4cat4c4c 
G78E1Ae3 
ocusuccc 
lcicicic 
3C3C3C3C 
scscsccc 
7C7TC7 CTC 
9cgcecse 
BCBCBCEC 
ococcrecc 
FCFCFCFC 
3211F°210 
sc2cz17c 
accc9e 47 
LASHUTFS 
1CiSFOL2 
ecalleea 
316C016C1 
£0064 38). 
BFICOOCC 
gecs2cco 


deesedac 
4a4o4uKG 
4O4G4 U4 
5aso31ge 
Ocececac 
1c1cicic 
3C3C3C3C 
5CSCSCSC 
TCTCTCIC 
9c9C9CoC 
BCBCBCBC 
ecrcococ 
FCFCFCFC 
02103212 
CIesFu24 
DC28168E 
969F 1036 
4TFOEIO6 
43817016 
41CCCiU92 
5u1l641BB 
0900394 


47BC4U2C 


ccooce30 
4ood00c34 
Scaqocou 
—sooduro 
oocuacce 


acackice 
ococococ 
4o4u0c00 
4as1oan2 
eccoq4as 
1C1D1C1C 
3C303C3C 
SCSESC5C 
ICTOICIC 
ICITICIC 
BCBOBCBC 
CCCCECCC 
FCFOFCFC 
200EN7FE 
Fo24C793 
Lesussaz 
S8EDSCOC 
9108FUG3 
laeeoila 
SLCO21P 8 
00014281 
oooc0017 


41A03017 


coccocce 
QOCOUCEE 
1C4n4uoue 
onco9017 
coeciocal 
C3C44Co7 
4C4aanac 
O7FEQOOC 
Sez5acoc 
ecccacac 
2czc2c2ce 
4C4C4CaC 
6CECECEC 
ececeCet 
ACACACAC 
ccceccce 
ECECECEC 
F2z432aC 
eccuenot 
iqigidic 
eCC4477C 
C7FEQSAC 
471NA02— 
BOCO478C 
51013185 
GO16ODSuC 
cocooooc 
56 FOACOC 


Cocecccc cccococc 
ooececcc a200c79e 
ecoccicee ceooeocce 


Ecccoesc ccocccce 
ceccecce cououcoc 


COCEDICE CSEICSCE 
SC4C4eSe 4O40KT4C 
C58C561C 8C361211 
502C317C 18985ASC 
oc€ceclee cucecacce 
2c2czcz¢ 2C2¢zCz¢ 
8caHcacac 4c4cacac 
6CECECEC BCOCECEC 
acacecec scacscec 
ACACACAC ACACACAC 
ceccecee cececece 
ECECECEC ECECECEC 
2cfecctc 3z0ercir 
9zcc2C17 LIFELCCE 
c7cz1cCe 10089C4? 
ec2sozCc 9CGFscc4 
OSCCFCOZ 10164770 
DSCCICIE FrC247eCl 
AOHAUSCL ACTZ47FC 
47ECACEE 91102188 
1C1€1C17 C7DCS201 
oocco3es cECic1C} 
EQAIOOLe 47FOUDLE 


He rcccccccccccvccecccceconcccccee-COGI4C 


Peer vvencecccsecs veveccvcsesesce-C Gl 16C 
Haves eeesevvconene eveceese-OOlC 180 
Becccvccccccccvcelecccvvccsonecoe Chl LAL 


Beocccvereccccvnscsceccvescvsevee Cll ICC 


PesvcccccvecsccenveuKLM PRCFERTIE-COCCOE 
*s eoee ~CeCece 
* eovccceseccsee Cul zul 
Bovccavcrecscccseleovsceeeciccdse re “COC stl 
Beeedecsscsccsccvccvccccccvcssscoee Cul cel 
BocccsccrecescvccvesscccsssesccseCil ZAL 
BrcccccccesevccveveesK KKK C CEC CE HC OL ECL 
BC (CC eden ESR E DO HR OATATTTIIITWAY-CCCZEC 
PX _LEVADATITGITATITII GT eesocceseses Gil ive 
Heccesecvcsccncccessccccsesesceee Chl iZl 
PB rvccvvesccsvncnesecvccsvevecsses-CUl INC 
Perens esecccsccsccvesescescovess Cl JEL 
PrcccccecccsccesccsescovescsseeboCUOIBt 
BZ eccvecseslieKocccccccs_evsceseseCCliIAlL 
Boece ve cha edP el eliePecceePaveveve Lil icl 
Pecveveccncsevcccvcccsvvceekeesse-CCCiE€ 
MeCoccbscacctscvvesccesceheleseseGCCHOl 
WecceeK coelealeaselesveeNoeslese-CCCu2e 
Pevceccerecnsccevesescaveelevevel “CCC 44C 
BeeelCeeeCecehenvsbovccvececs ceo CCl u6l 
PevereeelevccccccessceeNoescesese Ci Cue 


Hercccccccccesvccccccccnvccesesse-COC¥AL 


Bocccerteceleses seovveeleskeseet e-CCCUCE 
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——————— ee 
COCKEQ-BCCECOOO C3S4D203 ICOHHCIA YSFEQU32 BOOXOIEC 41 A3UCEE SCALOUCE S7FOEDCE FrececcKene secccees_coccbsvecl o e-COCKEL 


CCCSOO-OSEQ47FO 80148010 GOUDDCOD OO8OOO3BS8 CCOCOOOCEH CO2E181C SEDCIIEC SCIOCCCE PeeelCeccccsccnsccsescccesssebbeeeOOCEND 
COCS2C-SCEDCOOY C7C8307B SC7BY7FO BOBASSCC 31084AC1 GOLZ5S82C CLCCSC2ZC FLTCSBIC Mb eeeP oat eMeloevcaclLMocevsckecde so COCE2Zl 
CCCSHO-8CEGIA93 SAAICUNB SEFCACLO 41FC3U85 19OAF4YTTO BOEESOCE 31BB92CIL ZSIBCIICI Feececcee ela eelacscsesrLoneehvave Cll EMl 
COCS6C-318947EO BCOEILIU 31684 7EC BUGEDAZE SeACIUBS GALOBOLZ SCLACCOE SBFICLOC *evveerevveves reccveslesebssssles-COl Sl 
COCSPC-1ZFF4YTBC ECSZ1AF3 SECIZDCO S8ACO154 LAASISEF SBEDUCON SACCCCOE CTFEPCIE Feeccccetocveccccccccsvcvccsescee COL Eat 
CUCSAO-OCCOG4SAS COLGOOIO UCSOUCCO FuFuFUFG FOFUFUFO FOFCFCFC OLCCOCOO SBICBCSE Heccecvecev asl CLCUCLCUCEGeaeevvee-CCCEAL 
CUCSSC-141358CL ZICB4ADL IJCCELESO SBFUBLIA LAF3INSEF S2CNICDE SSAAICIC H7TOECEA FevcvcalveccneDecetacvecsesevesee COC ECe 
COCSEG-SEFOSNCE LAF3OSEF 47FLS1C2 S@FCF1IC CSEFSIIG STIENTEC SICZSSFL SCLYLZFF HeCoee&®leaelvaclLesesevcccvvveiasee-COCEEL 
CCCONC-477IOEICE SSFUIGES SSAIZSHRB 4770812C SEAIZLEB YAFOBCIZ IGEESCEA ULCUCH TFL Feeveeloneccccsasevvelesovebosssl-OClEfl 
COCE2C-eCS25822 SCL34770 G1S64I11 CUI4IZFL LCOLSBFU SUAZIZFF 4TBCELYE SCFOSBCSE -Fevecccccccncccelvcnlacscenvebl oe ChCEZL 
COCO4O-O7FCZEVAZ BCAZHTFE BCBAGEFOS FU15O208 3L7ERCAA YTFOBLIZ SCBCOCCIY SAFNICEC PPeeesenleaeleeKoatnvelesksvocel se-CLlENl 
COCEEQ-4IFFECON CEEFS8B8D JCI447FN Bu2COLSC 9 CS8U5ESL Z1EQGODE SLBHOTIZ GOCCOCLE FeveecevsceelossvcessclovesFousse-(CCEEL 
CCCESG-FEF2Z5017 320CFDF2 SCLI732LF FE3SC323O SULTINOF ZZINOZLC 32343Z1Z SACEDLEN FE Pe eecetavcelenvaceseehovcensees OL LEBl 
CCCEAC-CTFECEAG £€503150 SCCEF1ES FBCEGS164 SISOILFF CTFESEAC ZISCOCLE ACLCSSZO Peeceeee i scesvcvecensceventeesese-COCEAL 
COC6CG-310C65800 FIGC56CO 3CFCSSBC ZCEHDED? ZCCCICOC VTEBSEHEC SIBEINTF SIBBESBC Mecca ceeeceseelOeccvecvevcserseee Cl CEC’ 
CCCOEC-9EFO2043 477TIBOLA 92272047 92022046 41INZOU35 CSECIZO£L ZCHBSZCC ZCYCSELE FelCecevevvvvcnnvessvescseveseete oe TOE El 
CCOCTCC-ACCOCL7FE S8@aC3150 SCCEACCO 582031NB SeON31CC SBCOSSFC SSSCOSFCL SLITUTTIC FeeawvnnEsnvncesvscevvsevesel vee eOL0I9C 
COCT2C-@CZES25]2 ZC48921U 2C4ASES2 CO3B924E FUOUCZZE GOCIIGTC SBICOOEG ISEIVIZCT Feeeeeesveleeeee weKvovevesessl eo COL ize 
COCT4HU-2C4641L2 COIBOSED GUS8O4TFG @CLEYOFC BCCISECE ACCOUTFE SBCEACCO CTFELCECO Hevecccsveeal ene neccevecseveses CU lal 


COC7TEGC-CCCOC7E4 Se82ca3e FI53BCCH ee Ol ECOSH7LS STICFEFC BuCPFE 22 BZ3IDIZIC Heeveneccraccccreserseceeiesesscee CCC IEC 
(ADD2) 



























COC7TeC-CzZ1OENI2] W234924y 3e 72353234 O7FEICOO LAICAGGCC J4YC4CFekFs BK eevee cokeovssececesess 8°C -NCC7eC 
COCTAC-4HCHT4CFO [4C4OC1D2 CIOH4lT7? CHDEDTICS CSEICICS E24NHOHE 4OHC4LNC HO4CHCYC} * "  sKEM PROPERTIES -CCCIAC 
Coc7ca-4cC4o404d 4CKhONOIY a4o008CEs COO.cCcac occceudc Ceecuecs CiccCcree LCOCCCEE * ee erecceconanscscvoseveves Cll iCl 


COC7TEC-CCCOC4SGOD C3C4HCEOC9 O3CS4O4C BUN01ESO OGDOIISA LOCOOBFCL CLICCKOE ADFFFFOC *eeeeCLFILE sesbsoureoelCovsesees Cll TEC 
CCCEOU-COCOING2 C2CGC798 GCUOUCZE OG2ZCHINC 82089204 GOZCUCUC COCCOTSS SCUOLCEL Fecevecenecccrcccecsecesesesseces C00 &Ck 
CGC820-OCCOOOCO CCCOCL CO GCOGICCOH O2CG4IG COLVSUSU 4OHOFOFC FUFCFZFE YOC4OUDKC Meecveevevccccccces OOGL 26 ~CCOCEZ 
COC84O-4C4O4N4O CIC2C34O EIDSEYC3 D2C9NSC7 4CC3DE4BR 4C4CKCUE YLHC4CHC 4CHC4C4Ue * ABC TRUCKING CCe ~OCCESC 


CCCe6eo-4scC4ococo Ceccacod ocoosces COCOOLOC OGOOOUNO GHCOOBAY CECCOEBSE CCUOCOCE * cevecencesvcsvessevccvessevsenCUlebl 
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eSy 








COC88O-OCCOO4OO C7C9CECS O3C5404N BONGI513 OOOUDFAC GOCIO4YFE FEZCCCOE L2FFFFDC *eeoePRFILE cocssccvereDbseveeeeONGesl 
(ORB CURRENT RECORD ADDRESS 
COCBAD-CCCOCF96 CICOO832 OCOCICIY DO2c44OC B49A2004 EOZCOCYS CUOCOB2Z COUCCOCE secevcvcevccerecccescversvesscese Cll EAl 


azooa7s8] cocceace OC2Z090L1 OOCIOCFF FFFFFFCL COUCCCI1| *evcccecvecccccvvcccscvessnseccesOUlece 


1ORB FILENAME 
CICNCECH DACEACNC! Se ceiws as edhsieneanee -ccceec 


CcCong-OCcNCazs2 CCOONGON YC3IUCE] WOOLZIZFF FFFFFFOO JOCOOS1I LLSCOOCC COUOCCCCE Fesrceveccscccrvsnvenvvcscvssesee e-OUl SOL 









CcCacc-accnooco 423c0000 


CCCB8EL-ICCCCCOCO CCCOCUOO ocdcu7Cce fcooNFAC ScCOuNDOL veCcooooc 





COC92Z0-SCCIGB68 CCOLCE4S COOLICEL BZSCCILIC CICSCECI CICSHOHO CSFCOCHZ FOEAISTF FeecvvecvceceeseePFFILE elooCeoo"-OCCSZL 
COCS4HU-LE4OGIOL 4OC194710 FOBEDLAO YOLE47ED 7U26918Z YOCESTSEC TLZESEFC ZCBEYCEEF Fe oo oevveee sevveee svevesl(veee Cll S4l 
COCSEL-SEZO4TIE 4TTICTIOA ISCCHCCE 477CTLHA SEIT4EMU SSCOHCDE 477ICTCEC IBSEYFELC Fee covsves seeccne toe cesetev ck “COC SEL 
COCSBC-4CCSCEEO 4ZS5G7053 9ZHOOCCO C2E0GUOL YIGOUHTFO FIEALALY SBFCIIIG GSEFGSTC # welsbowe seKececsslLesseclocseeeCLlsal 
COCSAD-SE7TOTNEN SECUZISU 4Y1IDDUIIC 4ICSPVEA ELCOULGY SEISHCZC SETCHCZY CSETCE TC AcvaveveEsccenccvkssenn coe care e-QUCSAal 
COCSCO-SE7TO7TOSO 4PFOTLII LEFFIZFF S7TEG7UCA F2FU3TES FIINGOLE YTICTEEZ SCFOTCEE Heeveelecencsccnvelevee eosevbl oh~CUlSCl 
COCSEU-CZC131E1 TOESCZID 328370E9 96427GEA 91013189 HTEIFOCC CAIESEEC ZIBCLIFE #K eeeehK sever venccccccviovesescee CLL sel 
COCADO-4IFCTCES QIECHOLE UIECTCEC SSCCUCIE H77UTLEC SEFO3DBY CEEFSENZ TCEAGTFE *slecce ceccces cocvscMeccesces es -CCEALE 
CCCA2C-CCCOCSCH COCGIUOG SEYE2CCSD COCCILMC CCCOILCE STCOUSIZ CCCCLCECE CCOLCHIC Feveeccvvevcesvececechvsvceshusse-CUHh2t 
COCAYC-OCCOG832 COCOSTEY CESTIERC SUCGOSF2 SCCOLSIA SOCNGECE COCLOGAY COGICECE *oeneceevascbverbcenesstevevecsh-CCL AMC 
CUCAGC-CCCOCOC] CCCOOUOO USFESPZO ZIS09ZFU 3C8SSO1D ZICHSCAC FIBEHEIC FCBESSCE Feeveseceeiacederocsceekecseshess Cll Abi 
COCABC-2103478O KC7zO201 Z1BELCCZ 95072112 APRCEYSZ2 SSCBZIG2 SYTACFOES HLINZICL FeeeeleKevessevecvslecveceslessne-ClhO rae 
COCAAC~£C103188 SZFU3ZLEu 91933189 4T7GFCAC FICBILEA YTIDOFCOC YTFCFOAC GICCIOCO Fh eveeTesceveceleveneoalesl Coven e-COl sal 
CCCACL-S7ECFO32 SZE73L5U 91033189 S77UFUGE FLOE3LBA YTIDFOOC SLILZICY FECFZILE BeeleeKoecccccelrevevselebessesee"COCACl 
CCCAEC-OA2BCEEC S1UEOIB YIFIECLC SCOONIAG BANFOZED ZLETILIU2 ZIBGHTIC FCACIICE PeeeecevcclocerccccsreceesvesleesCUl rel 
COCKOO-316A4N7EN FCACSB1G 33A45CIC 21C4SEDY Z1BK47FL FRREGAZE SSILFLEE STFCFCEA FeeeeleccccbvoccceselGsoessbeslbe-CCCECL 
CCES2T-SCLCOICO CACFHCBES CLLSYCCO MAMNOALOC CLCOUGL Su COLGICGC COCCCCLECO CLECLCCO PeneeeeKacvevcccecccsecsensesesseCUlE2c 
COCR YC-CCOCOCCCO CCCOCODD SCUSULCS SYOVOCIG ACAYACIY GMESGCIC COCCCCLC CCOCCELE Fecnvccveccccnsvccvecsesesseseves Cll EMC 
CCOCBEC-CCCHCOLO CCCOCKID GAIIS@IC 315041I9G OCOLHLZ2U GOCAHLEC SGBEGAFS GOFOG2CO PavececcvenevelescesvecsveveleceeCilEel 
COCBEO-CCS3S180 LUOUN7TE8O OCSES2F2 ELOCBINC CCDIYEZG COMEYTFC COTCHCCE CELSHTC] Feveccvvensetovesevceetoded FCR A-CUCEBC 
CCCBAC-C2C340C6 EXEZCTEN E34OD2CS IBIOLCTIC 4110199C SHIUOCBC STFCECIOC 4CCOCCCCH FLL OUTPLT Lleseveceneccoeles evo -CCCEAL 
COCECO-O41112CC 47BGCGIA AAICOSCHY 1GCCOLGA GITGDGAL SOCL31IBS CZCICLEC CZBRCELE FevenreccreNeveresccessaekedeKeNo-~CUCECl 
COCBEQ-1CCICIOF Y77CCUBC G4FEZLES DSCTICCE CLAS477U COLD96G? 31890201 CIBCLZHB FeedevecvvsseNevedcosssecsekodok o-COCEEL 


CCCCOO-47FOCI72 SCBU3Z1I8C 4IBOOLBE SUBUI174 IBCGSEFG 3GAGGSEF SICHZLIEC HATING ZFC FoCyebsoccvichseveeelseveetacveKe-COCCOL 
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Appendix A 
Program Exceptions 


Table A-1. Program Exceptions 


Interrupt Interrupt Cause 
Code 
01 Operation exception: An illegal operation has been attempted or an operation using a 


noninstalled processor feature has been attempted. 


02 Privileged operation exception: A privileged operation has been attempted by a program 
operating in the problem mode (PS, bit 14 of current PSW, set to 1). 


03 Execution exception: The subject instruction of an execute instruction is an execute 
instruction. 
04 Protection exception: A storage protection violation occurs on a program-generated 


address when the storage protect feature is installed. 





05 Address exception: A main storage location outside the range of the installed main 
storage is referenced by a program-specified address. For the load-control-storage (LCS) 
instruction only, the referenced control storage location is nonexistent. 

06 Specification exception: 
© The unit of information referenced is not on an appropriate boundary. 


e — Aninvalid modifier field is specified in the service timer register (STR) instruction. 


° The "4 field of an instruction that uses an even/odd pair of registers (64-bit operand) 
does not specify an even register. 


° A floating-point register other than 0, 2, 4, or 6 is specified. 
e ~~ A multiplier or divisor in decimal arithmetic exceeds 15 digits and sign. 
e The first operand field is shorter than, or equal in length to, the second operand in 


decimal, multiply, and divide instructions. 


continued 
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Program Exceptions 





Table A-1. Program Exceptions (cont.) 


Interrupt Interrupt Cause 
Code 
06 (cont.) © — The four low-order address bits specified by the contents of i) comprise a set 


storage key (SSK) or insert storage key (ISK) instruction and are not equal to 0. 


© The function specified by the lp field of a diagnose instruction was not loaded in the 
transient area of control storage. 


© — ASOFTSCOPE instruction (SSFS or SSRS) was issued without the supporting 
microcode loaded in the control storage transient area. 


07 Data exception: 
e An invalid sign or digit code is detected in decimal operands. 
° Fields in decimal arithmetic overlap incorrectly. 


od The first operand of the multiply decimal instruction does not have sufficient number 
of high-order 0 digits. 


08 Fixed-point overflow exception: A fixed-point add or subtract operation exceeds the 
capacity of the first operand field. This interrupt is masked by b, bit 36 of the current PSW. 


09 Fixed-point divide exception: The quotient of a fixed-point divide operation exceeds the 
capacity of the first operand (including division by 0), or the result of a convert-to-binary 
instruction exceeds 31 bits. 


OA Decimal overflow exception: The result of an add decimal, subtract decimal, or 
zero-and-add instruction exceeds the capacity of the first operand location. This interrupt is 
masked by d, bit 37 of the current PSW. 


0B Decimal divide exception: The quotient of a divide decimal (DP) instruction exceeds the 
capacity of the quotient part of the first operand field. 


OC Exponent overflow exception: The final characteristic resulting from a floating-point 
arithmetic operation exceeds 127. 


OD Exponent underflow exception: The final characteristic resulting from a floating-point 
arithmetic operation is less than 0. This interrupt is masked by e, bit 38 of the current 
PSW. 

OE Significance exception: The final fraction resulting from a floating-point addition or 


subtraction is equal to 0. This interrupt is masked by s, bit 39 of the current PSW. 


OF Floating-point divide exception: The divisor fraction in a floating-point divide operation is 
equal to 0. 
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eo Appendix B 
SYSDUMP File Allocation 


This appendix contains information about $Y$DUMP file allocation. 


Table B-1 shows the number of cylinders required, depending on your system’s main 
storage capacity and the type of disk device you are using. 


For example, a system with 8MB main storage requires 53 cylinders for the 
SYSDUMP file on an 8433 disk drive. 


Table B-1. SYSDUMP File Size in Cylinders 


Disk Type 


Storage 
(MB) 
& Cylinders Required for Use 


= 
a 
wi 

fs 
WN 
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Use the following procedure to expand the size of the DUMP file after an increase in 
storage: 


1. Use the following JCL to scratch the $Y$DUMFP file on SYSRES: 


// JOB SCRDOUMP 

// DVC 20 // LFD PRNTR 

// DVC RES // LBL $Y$DUMP // LFD SYSDUMP 
// SCR SYSDUMP 

/& 

// FIN 


2. Use Table B-1 to determine the number of cylinders required for your system. 


3. Use the following JCL to allocate a MIRAM file (labeled $Y$DUMP) and to 
execute the SG$OPN load module: 





// 3§0B ALLOCATE 

// OVC 20 // LFD PRNTR 

// DVC RES 

// EXT MI,C,1,CYL,xx (where xx is the number of cylinders) 
// LBL $YSDUMP // LFD SYSDUMP 

// EXEC SGSOPN 

// PARAM SYSDUMP, 108 

/& 

// FIN 





You now have sufficient contiguous free space to store a dump of your system’s main 
storage. 
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